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PREFACIO 


Criar o design do relatório diretamente em XML pode ser uma 
tarefa muito demorada e improdutiva. Seria bom se existisse uma 
ferramenta fácil de usar e intuitiva que automatizasse esse processo. 
O iReport veio preencher essa lacuna, facilitando a definição e o 
design do relatório com um ambiente gráfico e com todos os 
recursos que a biblioteca Jasper oferece. 


O iReport facilita a definição de relatórios com designs 
modernos e complexos, sem a necessidade de escrever uma linha de 
código em XML, e é todo gerado automaticamente. O ambiente 
disponibiliza para o desenvolvedor atalhos para tarefas de 
compilação e visualização do relatório, proporcionando a realização 
de testes e, consequentemente, uma maior produtividade no 
processo de design. 


É uma ferramenta gráfica que possibilita desenhar e configurar 
um relatório ao arrastar e soltar componentes, de forma bem 
parecida com a criação de interfaces e janelas de algumas linguagens 
de programação com Delphi e Visual Basic. 


Ao salvar, automaticamente será gerado um arquivo JRXML 
que será utilizado em uma aplicação. A vantagem é que não é 
necessário conhecer a fundo o XML a ser editado, economizando 
tempo de desenvolvimento. Ele também disponibiliza um conjunto 
de modelos (templates) que pode ser usado, sendo possível também 
escrever os próprios modelos para serem reaproveitados sempre que 
houver necessidade de criar um novo tipo de relatório. 


Este livro apresenta, de forma didática e prática, como utilizar os 
recursos do iReport para implementar relatórios com Java. 


O leitor aprenderá como: 


. Utilizar a interface de desenvolvimento do iReport; 

. Criar o design do relatório; 

. Criar parâmetros, atributos e variáveis em um relatório; 

. Gerar relatório utilizando como fonte de dados ArrayList; 


a FW HY 


. Gerar relatório utilizando como fonte de dados instruções 
SQL; 

. Gerar relatório com gráficos; 

. Gerar relatório com sub-relatórios; 

. Gerar relatório com Map; 


OD CON DW 


. Gerar relatório com Crosstab. 


O leitor deste livro tera a oportunidade de entender detalhes de 
como implementar relatórios utilizando iReport com extrema 
facilidade e produtividade. 


O livro tem por objetivo mostrar para estudantes, 
programadores e desenvolvedores quais são os conhecimentos 
necessários para implementação de relatórios com Java usando um 
dos principais framework da arquitetura Java. 


Participe das discussões sobre o livro iReport: Crie relatórios 
práticos e elegantes, em http://forum.casadocodigo.com.br, para 
tirar dúvidas, críticas e sugestões. 
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CaríTULO 1 


INTRODUCAO 


Nos próximos tópicos, enfatizaremos as principais 
características do JasperReports, e também vamos baixar e instalar o 
iReport para podermos exercitar os nossos exemplos de criação e 
geração de relatórios que vamos demonstrar. 


1.1 JASPERREPORTS 


O JasperReports é um framework open source, gratuito e o mais 
usado para geração de relatórios, capaz de criar os mais complexos 
relatórios para aplicações Java. Como é escrito em Java, também é 
multiplataforma. 


Por meio de uma interface gráfica e intuitiva, o desenvolvedor é 
capaz de criar diversos tipos de relatórios de forma simples e rápida. 
Essa biblioteca proporciona uma grande facilidade na organização e 
apresentação de conteúdo, possibilitando a geração dinâmica de 
relatórios. Ela também pode ser usada em qualquer aplicação Java, 
como: aplicações desktop, web e distribuídas. 


O iReport é um designer/construtor visual de relatórios de uso 
fácil e intuitivo para o JasperReports. Por intermédio desta 
ferramenta, podemos visualmente construir relatórios complexos 
contendo gráficos, imagens e sub-relatórios, uma vez que o iReport 
é integrado à biblioteca do JasperReports. 


Dentre as funcionalidades do JasperReports, podemos destacar: 
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e É capaz de exportar relatórios para diversos formatos, 
tais como PDF, HTML, XML, XLS etc. 

e Possibilita a entrada de dados em diversos formatos, 
tais como arquivo XML ou CSV, conexão com o banco 
de dados, uma sessão do Hibernate, uma coleção de 
objetos em memória etc. 

e Possibilita o uso de imagens, gráficos e localização 
geográfica. 


Estas características, junto com a facilidade de utilização e custo 
(open source), faz do JasperReports uma biblioteca de geração de 
relatório em Java completa. 


Fluxo de geração de relatório 


O layout do relatório é definido em um arquivo XML, 
normalmente com a extensão .jrxml . Este XML contém todas as 
informações do relatório e também os campos que serão 
preenchidos posteriormente de acordo com a fonte de dados 
utilizada (data source). 


As etapas para geração de um relatório são as seguintes: 


1. Após compilar o relatório XML, o resultado é um objeto do 
tipo JasperReport. 

2. Usamos a interface data sources para preencher o relatório 
com os dados. 

3. O JasperReport processa o arquivo .jasper junto com o 
data source, tendo como resultado um objeto do tipo 
JasperPrint. 

4. Podemos então enviar objeto do tipo JasperPrint para 
impressão diretamente ou exportar para um outro formato, 
tal como PDF, por exemplo. Na figura a seguir, ilustramos o 
processo de geração de relatório. 
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Figura 1.1: Fluxo de geração de relatório 


1.2 INSTALAÇÃO DO IREPORT 


Quando iniciei a escrita deste livro, a versão que estava 
disponível para download no site era iReport 5.6.0. 


Download iReport Designer 


Primeiramente, deve-se acessar o site 
https://community.jaspersoft.com/project/ireport-designer/. 


Então, dê um clique no link Download iReport Designer . 
Você encontrará opção de download para diversos produtos da 
Jaspersoft, clique no link iReport Designer . Lá, haverá a opção 
de download do instalador para diversos sistemas operacionais, 
então, selecione a opção equivalente ao seu sistema: Windows ou 
Linux, conforme o caso. Faça download e salve o instalador na pasta 
de sua preferência. 


No nosso contexto, instalamos a versão Windows: iReport- 
5.6.0-windows-installer.exe e usamos o Java JRE na versão 
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1.7. 


Para quem utiliza o Java 1.8 ou superior, recomendamos baixar 
o Jaspersoft Studio , que tem as mesmas funcionalidades do 
iReport. Recentemente, foi divulgado no site 
https://community.jaspersoft.com que o iReport será 
descontinuado e será substituído pelo Jaspersoft Studio. 


1.3 INTERFACE DE DESENVOLVIMENTO 


Ambiente 


A figura a seguir mostra a tela principal do iReport. Ela contém 
todos os recursos necessários para criamos o design e configuração 
do nosso relatório. Vamos agora entender alguns recursos 


disponibilizada nela. 
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Figura 1.2: Interface de Desenvolvimento 


Estrutura do relatório 


Podemos ver na figura a tela que utilizamos para desenhamos o 
relatório. Ele está dividido em 7 seções, sendo cada uma responsável 
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por uma funcionalidade. 


Figura 1.3: Estrutura do relatório 


e Title (título): é a primeira seção visível na construção 
de um relatório vazio. Esta seção só aparece uma vez no 
começo do relatório. 

e PageHeader (cabeçalho da página): esta seção aparece 
no começo de cada página impressa. 

e ColumnHeader (cabeçalho da coluna): esta só aparece 
no começo de cada interação com a seção Detail. 

e Detail (detalhe): esta seção é o local de exibição dos 
dados de um objeto data source ou query. Ela se repete 
enquanto houver linhas para serem colocadas no 
relatório de acordo com o resultado transmitido. 

e ColumnFooter (rodapé da coluna): esta aparece 
abaixo de cada coluna.análogo ao ColumnHeader . 
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e PageFooter (rodapé da página): representa o rodapé 
da página. Essa seção aparece no final de cada página. 

e Summary (sumário/resumo): representa o rodapé do 
relatório, só aparece uma vez ao término do relatório. 








Menu Paleta 
Este menu tem todos os componentes que podemos usar em um 
relatório. 
: Paleta > x 
(=| Report Elements 
H Break [E] Chart [5] Crosstab 
© Ellipse [| Frame [al Html 
Image Mi) Barcode 8 Generic Element 
EE List 4E Spider Chart [F] Table 
/ Line Q Map Cl Rectangle 
{Round Rectangle $ Sort bei Static Text 
FS subreport Text Field 
=| Tools 
T Callout F Currentdate  [#] Page number 
Page X of Y Percentage [#] Total pages 
= Web Framework 
$ Sort 
Figura 1.4: Menu Paleta 
SubMenu Report Elements 


Dentre os elementos disponiveis no menu Paleta, podemos 
destacar os seguintes componentes: 


e Static Text: utilizamos este componente para imprimir 
um label, por exemplo, o título do relatório ou nome de 


uma coluna. 


e Text Field: usamos este componente para imprimir o 
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conteúdo de um atributo, como o conteúdo do atributo 
código, descrição, sigla etc. 

Image: utilizamos este componente para imprimir uma 
imagem, por exemplo, o logo da empresa ou a foto de 
um cliente. 

Chart: usamos este componente para imprimir 
gráficos. 

Subreport: um relatório pode ser composto de N sub- 
relatórios. Utilizamos este componente para criar N 
sub-relatórios. 


SubMenu Tools 


O iReport disponibiliza algumas variáveis que usamos no nosso 
dia a dia. Dentre elas, podemos destacar: 


Current date: utilizamos esta variável para imprimir a 
data atual, como a data de impressão do relatório. 
Pager number: usamos esta variável para imprimir o 
número da página. 

Page X of Y: utilizamos esta variável para imprimir o 
número da página com contagem em regressiva, por 
exemplo, 1 de 10, 2 de 10, 3 de 10 etc. 

Total pages: usamos esta variável para imprimir o 
número total de página do relatório. 


Menu Report Inspector 


A seguir, veja o menu que usamos para adicionar e configurar 
recursos ao relatório. 


1.3 INTERFACE DE DESENVOLVIMENTO 7 








-[8] Styles 
SF Parameters 
-S Fields 
Variables 
Scriptiets 

Title 

Page Header 
Column Header 
Detail 1 
Column Footer 
Page Footer 
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Figura 1.5: Menu Report Inspector 


Dentre os recursos que podemos adicionar ao relatório, 
podemos destacar: 


e Parameters: nesta opção, adicionamos os parâmetros, 
por exemplo, o período do relatório, o path de uma 
imagem, o nome da empresa. 

e Fields: aqui, adicionamos os atributos que usaremos no 
relatório. 

e Variables: nesta opção, adicionamos as variáveis que 
vamos utilizar no relatório, como Total Faturamento 
Diário, Total da População de um Estado etc. 


Menu Propriedades 


Utilizamos este menu para configurar os componentes que 
adicionamos ao relatório. 
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: Hello Wolrd - Propriedades Db 
Properties expressions No properties set fa) 
(=| Static text properties 

Text Hello Wolrd (a) 
(-|Text properties 

Font name [Sansseif o] 
Size 14 Y 
Bold [9] 

Italic E] 

Underline 

Hello Wolrd 4 


Figura 1.6: Menu Propriedades 


Dentre as propriedades de um componente Static text, por 


exemplo, podemos destacar: 


e Font name: selecionamos o tipo de fonte. 


e Size: selecionamos o tamanho da fonte. 
e Bold: opcionalmente, podemos imprimir um label em 


negrito. 


Configuração da página 


Para mudarmos a configuração da pagina do relatório, 
precisamos ir ao menu do iReport. Após criar um relatório, clique 
na opção Arquivo . Será visualizado um submenu, clique na opção 


Configurar pagina. 


Nesta tela, podemos configurar a página de acordo com as 


nossas necessidades: 


e Orientação: disponibiliza 2 opções de orientação. 
e Tamanho: disponibiliza um lista de tamanhos. 
e Margens: podemos alterar as margens. 
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|| Configurar Página Ea = XT 














Papel 


Tamanho: A4 x 


Origem 





Orientação Margens (milímetros) 
(9) Retrato Esquerda: 25.4 Direita: 25,4 
© Paisagem Superior: 25,4 Inferior: 25.4 


Figura 1.7: Configurando a página 








Adicionando menu na Interface de Desenvolvimento 


Observe a figura seguinte no lado direito, não temos a opção do 
menu Paleta, mas precisamos dele para adicionar componentes ao 
relatório. Neste caso, o que fazer? 
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: Page Header - Propriedades px) 
(=| Band properties 

Band height 111 

Print When Expression P 


Split Type 





Page Header ty 














Figura 1.8: Adicionando Menu 


No menu do iReport, selecione a opção Janela . Sera 
disponibilizado o submenu com diversas opções. Sempre que 
precisarmos adicionar recursos a nossa interface de 
desenvolvimento, utilizamos a opção Janela do menu do iReport. 
No nosso contexto, para adicionar o menu Paleta , temos duas 
opções: 
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1. Clicar na opção Paleta. 
2. Clicar na opção Redefinir Janelas. 


Redimensionando área 
Para redimensionar as áreas dos relatórios, temos duas opções: 


1. Visualmente, clicando nas linhas que separa as áreas e 
arrastando para cima ou para baixo. 

2. No menu Report Inspector , clique na área desejada e, em 
seguida, no menu Propriedades , altere o valor da 
propriedade Band height , informando o valor desejado. 
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: Paleta Ob 

















& Spider Chart M] Table 
Zee we 
U] Rectangle {Č Round Rectangle 

* Sort bei Static Text 
FÉ Subreport [T] Text Field 

=| Tools 
T callout F Currentdate  {#]| Page number 
Page X of Y Percentage [| Total pages 
(=| Web Framework 

+ Sort 
' Page Header - Propriedades Ob 
=| Band properties 
Band height 111 


Print When Expression 


Split Type [Stretch 





Page Header | 


Figura 1.9: Redimensionando 


1.4 CRIANDO O PRIMEIRO RELATÓRIO 


Vamos, agora, criar nosso primeiro relatório, que chamaremos 
de Hello World. 


Hello World 


Esta é a tela inicial do iReport e, a partir dela, damos início a 
criação de relatórios. 
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Figura 1.10: Tela inicial do iReport 


Após um clique na opção arquivo , será visualizado um 
submenu com as seguintes opções habilitadas: New, Open, Open 
Recent File, Configurar página e Sair . Clique na opção 
New . 


A figura a seguir mostra a tela em que você define o nome, o 
relatório e a pasta de sua preferência onde você salvará o arquivo do 
relatório. Neste caso, o nome do relatório é helloworld , e estou 
gravando na pasta C:\Mauricio\Ireport\Relatorio . 
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Passos Name and location 





Report name: helloWorid E 


Location: |C: Mauricio \ireport\Relatorio 


File: |C:Mauricio Vreport Relatorio fhelloworid.jrml 




















Figura 1.11: Definindo o nome do relatório 


Na tela mostrada pela figura adiante, faremos o design do nosso 
relatório, pois ela contém todos os recursos necessários para 
criamos o design e a configuração do nosso relatório Hello World. 
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Figura 1.12: Interface de desenvolvimento 
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Veja a seleção dos componentes na figura a seguir. 


1. Clique no componente Static Text no menu Paleta ,e 
arraste para a seção Title do relatório. 

2. Dê um clique no componente Static Text que colocamos 
na seção Title ,e altere a descrição para Hello World. 

















: Paleta 0» 
4 Line E Map 
la Rectangle Ga Round Rectangle 
* Sort el Static Text 
FS] Subreport Text Field 
= Tools 
TE, callout F Current date [É | Page number 
Page X of Y Percentage [É] Total pages 
= Web Framework | 
$ Sort ] 
|: Column Header - Propriedades D> 
El Band properties 
Band height 61 
Print When Expression ( 
Split Type [Stretch i 
Column Header € 





Figura 1.13: Adicionando componente 


Com o componente Static Text selecionado, vamos agora 


colocar a descrição em negrito, selecionar a fonte e aumentar seu 
tamanho. 
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Menu Propriedade 





: Hello Wolrd - Propriedades 
Properties expressions 

=l Static text properties 

Text 

=| Text properties 

Font name 

Size 

Bold 

Italic 

Underline 


Hello Wolrd 


> 
No properties se ie 


Hello Wolrd (4) 


Sassi] 


14 v 
Fi 

















E 


Figura 1.14: Configurando propriedades 


1. Na propriedade Fonte name , selecione a fonte de sua 


preferência. 


2. Na propriedade Size , selecione o tamanho de sua 


preferência. 


3. Marque a propriedade Bold para descrição ser impressa em 


negrito. 


Dê um clique na aba XML 


kzmi version="1.0" encoding="UTF-8"7> 
<jasperReport xmins= tp 
<property neme="i re; 
<property name="ire; 
<property name="ire; 
<style name="stylel"/> 
<background> 
<band splitType="Stretch"/> 
</background> 
<title> 
<band height="79" splitType="Stretch"> 
<staticText> 










zoom" value="1.0"/> 
x" value="0"/> 
y” value="0"/> 


/Jesperreports.scurcet 


e será mostrado o XML do relatório: 


orge.net/jJesperreports” xmins:xsie"http: //wew.wS.org/2001/XMiSchem 


<reportElement x="125" ye"26" wadth="i6l" height="20" uwuide" £671 232b-f££7d-48Lf-bSLS-desclelsste?"/> 
<textElement textAlignment="Justified"> 


<font size="14" issBold="true 


</textElement> 


"/> 


<text><! (CDATA(Hellc World} ]></text> 


</staticText> 
</band> 
</title> 
<pageHeader> 


Figura 1.15: Hello World XML 
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Dê um clique na aba Preview e será mostrado o relatório em 
tempo de execução: 


Hello World 


Figura 1.16: Hello World 


Agora que instalamos o iReport, aprendemos alguns recursos 
que a IDE proporciona, criamos e executamos o relatório Hello 
World, podemos partir para os próximos capítulos em que vamos 
aprender a criar relatórios um pouco mais complexos. 
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CAPÍTULO 2 


RELATÓRIO COM 
ARRAYLIST 


2.1 APLICATIVO DE DEMONSTRAÇÃO 


Para que possamos testar e rodar os relatórios que vamos criar 
no decorrer dos capítulos deste livro, implementaremos um 
aplicativo de demonstração com todas as funcionalidades 
necessárias para poder executá-los. 


O aplicativo será implementado utilizando tecnologia Java web. 
Os relatórios que implementaremos fazem parte do Sistema de 
Gestão de Cliente, um aplicativo de E-mail Marketing da startup 
MMO DEVELOPER, especializada em desenvolvimento de software 
localizada em Fortaleza - CE , para gerenciar o relacionamento de 
uma empresa com seus clientes. 


O aplicativo será implementado utilizando os seguintes 


recursos: 
1. Tomcat como servidor de aplicação - Para maiores 
informações sobre Tomcat acesse o link 


http://tomcat.apache.org/; 

2. JSF 2.0 com ênfase em primefaces — Para maiores informações 
sobre primefaces acesse o link 
http://www.primefaces.org/showcase/; 

3. Como banco de dados, será usado o PostgresSQL, para 
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armazenar as informações do sistema - Para maiores 
informações sobre  PostgresSQL, acesse o link 
http://www. postgresql.org/. 


O aplicativo está disponível para download no GitHub em: 
https://github.com/mmmauricio/ireportCrieRelatoriosPraticosEeleg 
antes. 


Adicionando Libs 


Para o perfeito funcionamento de relatórios *.jasper em uma 
aplicação Java, faz-se necessário adicionar as libs mostradas na 
sequência. 


e commons-beanutils 

e commons-collections 
e commons-digester 

e commons-logging 

e Groovy-all 

e iText 

e poi 

e jasperreports 

e jcommon 

e jfreechart 


As libs jcommon e jfreechart são obrigatórias apenas em 
relatórios com gráficos; nos outros, elas são opcionais. Entretanto, é 
sempre bom adicioná-las também. 


Como o contexto de nossa aplicação é uma aplicação web, é 
preciso adicionar a lib servlet-api à nossa aplicação para que 
possamos exibir o relatório. 


2.2 CLASSES QUE VAMOS UTILIZAR 
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Nossa aplicação de demonstração é baseada na arquitetura MVC 
e é composta das seguintes classes: 


Camada model 


e UF - Responsável pelas informações da UF (Unidade 
Federativa). 

e Municipio - Responsável pelas informações do 
Município. 

e Cliente - Responsável pelas informações do Cliente. 


UF 


Para implementar nossa classe UF , usaremos o seguinte código: 
public class UF { 
private Integer id; 


private String nome; 
private String sigla; 


Get e Set 
} 
Município 


Para implementar nossa classe Municipio , usaremos o 
seguinte código: 
public class Municipio { 

private Integer id; 

private String nome; 

private UF uf; 


private Long populacao; 


Get e Set 


Cliente 
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Para implementar nossa classe Cliente , usaremos o seguinte 


código: 


public class Cliente ( 


private 
private 
private 
private 
private 
private 
private 
private 


Integer id; 

String nome; 

String endereco; 
String observacao; 
Double dlatitude; 
Double dlongitude; 
Municipio municipio; 
UF uf; 


Get e Set 


Camada DAO 


Na camada DAO ficam as nossas classes que interagem com o 
banco de dados, realizando as inclusões, alterações, consultas e 


exclusões. 


urDao - Responsável pela Inclusão, Alteração, 
Consulta e Exclusão das informações da UF. 


MunicipioDao - Responsável pela Inclusão, 
Alteração, Consulta e Exclusão das informações do 
Município. 


ClienteDao - Responsável pela Inclusão, Alteração, 
Consulta e Exclusão das informações do Cliente. 


Camada controle 


Na camada de controle ficam as classes responsáveis por 
capturar as requisições vindas da camada de visão. 


AbstractMB - Classe abstrata que implementaremos 
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com todos os métodos que serão herdados pelas demais 
classes controle. 


e UFMB - Responsável por capturar as requisições vindas 
da camada de visão e repassar para classe UFdao e, 
após o retorno da classe, UFDao retorna o resultado 
para a camada de visão. 


e Municipios - Responsável por capturar as 
requisições vindas da camada de visão e repassar para 
classe MunicipioDao e, após o retorno da classe, 
MunicipioDao retorna o resultado para a camada de 
visão. 

e ClientemB - Responsável por capturar as requisições 
vindas da camada de visão e repassar para classe 


ClienteDao e, após o retorno da classe, ClienteDao 
retorna o resultado para a camada de visão. 


2.3 MÉTODOS PARA VISUALIZAÇÃO DOS 
RELATÓRIOS 


Como vimos anteriormente, um relatório com JaperReport pode 
ter diversas fontes de dados. Neste capítulo, a fonte de dados que 
usaremos será ArrayList, ou seja, uma estrutura de armazenamento 
que pode conter N objetos. 


Método gerarRelatorio 


Na classe AbstractMB , adicionamos o método 
gerarRelatorio . Este implementa o tópico Fluxo de geração de 
relatório que vimos no capítulo anterior. 


O método gerarRelatorio é responsável pela execução e 
visualização do relatório, como também por acrescentar parâmetros 
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comuns para todos os relatórios, como, por exemplo, imagemLogo . 


Inicialmente, instanciamos a classe HttpServletResponse 


para que o usuario possa visualizar o relatório. 


public void gerarRelatorio(String nomeRelatorio 
HashMap paramRel, 

List listaRel) 

throws Exception { 


FacesContext context = 
FacesContext.getCurrentInstance(); 
HttpServletResponse response = 

(HttpServletResponse) context.getExternalContext() 

.getResponse(); 

ServletContext sc = 

(ServletContext) context.getExternalContext() 

.getContext(); 

String relPath = sc.getRealPath("/"); 
String imagemLogo = 

relPath + "resources/imagens/logo_mmo.jpg"; 
paramRel.put("imagemLogo", imagemLogo); 
paramRel.put("nmSistema", Constants.NOME SISTEMA); 
paramRel.put ("REPORT LOCALE", new Locale("pt", "BR")); 
JasperPrint print = null; 


A classe JRBeanCollectionDataSource transforma o 


Arraylist em um datasource e, em seguida, a classe 


JasperFillManager gera o relatório. 


JRBeanCollectionDataSource rel = 
new JRBeanCollectionDataSource(listaRel); 
print = JasperFillManager. 
fillReport(relPath + "relatorios/" + nomeRelatorio + 
" jasper", paramRel,rel); 


Com o relatório criado, nesse contexto configuramos o objeto 


response para mostrar o relatório no formato .pdf , e a classe 


JasperExportManager exporta o objeto print para .pdf. 
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response. setContentType("application/pdf"); 

response. addHeader ("Content -disposition", "attachment; 
filename=\"" + nomeRelatorio + ".pdf\""); 
JasperExportManager .exportReportToPdfStream(print, 
response.getOutputStream()); 
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ServletOutputStream responseStream = 

response. getOutputStream(); 
responseStream.flush(); 
responseStream.close(); 
FacesContext.getCurrentInstance().renderResponse(); 
FacesContext.getCurrentInstance().responseComplete(); 


Classe UFMB 


Na classe UFMB , adicionamos o método relatório , que será 
responsável pela chamada da consulta, pela preparação dos 
parâmetros do relatório e pela chamada do método 

gerarRelatório . Nela passamos os seguintes parâmetros: o nome 
do relatório que deve ser visualizado, os parâmetros do relatório e o 
arraylist com as informações que serão disponibilizadas. 


public class UFMB extends AbstractMB { 
public void relatorio() throws Exception { 


try { 
List<UF> listagemResultado = ufDao.consulta(uf); 


HashMap paramRel = new HashMap(); 
String nomeRelatorio = "relUF"; 
gerarRelatorio(nomeRelatorio, paramRel, 
listagemResultado); 
} catch (NegocioException e) { 
addMsgErro(e.getMessage()); 


UF. xhtml 


Na página UF.xhtml de nossa aplicação, incluímos um botão 
da tag PrimeFaces para poder iniciar a execução do relatório. 
<p: commandButton 

value="Relatório" ajax="false" 


actionListener="#{ufMB.relatorio}"> 
</p:commandButton> 
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2.4 CRIANDO UM RELATORIO DE LISTAGEM 


Layout do relatório 


Nosso desafio inicial é implementar o relatório de unidade 
federativa, conforme layout da figura a seguir. 








SISTEMA DE GERENCIAMENTO DE CLIENTE 07/02/2015 
a DEVELOPER 
Pagina 1 de 1 
Relatorio de UF 
Codigo Nome Sigla 
8 Acre AC 
3 Ceara CE 
6 Maranhao MA 
7 Piaui PI 
4 Rio de janeiro RJ 
5 Sao Paulo SP 


Figura 2.1: Layout do relatório 


O relatório é composto de um cabeçalho, que contém: 


Uma imagem com o logo da empresa; 
O nome do sistema; 

A data de impressão; 

Contador de páginas; 


Qt so o O A 


O nome de relatório. 


Em seguida, uma área é reservada para colocar o nome das 
colunas do relatório. Normalmente, é o nome que identifica o 
atributo que será mostrado na mesma coluna na área Detail 
Finalmente, temos a área Detail que é onde colocamos as 
informações da UF que serão mostradas no relatório, que é o seu 
objetivo principal. 
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Adicionando parâmetros no relatório 


Para a implementação do nosso relatório, vamos usar a interface 
de desenvolvimento do iReport. Como já foi dito anteriormente, 
fazer o relatório diretamente em um arquivo xml é uma tarefa 
muito custosa e improdutiva. Para isso, utilizaremos a interface do 
iReport por ser bastante intuitiva e de fácil manuseio. 


Após criar o relatório relUF , estando na interface de 
desenvolvimento no menu Report Inspector : 


Primeiramente, vamos adicionar o parâmetro imagemLogo que 
será usada para mostrar a imagem do logo da empresa. 


Clique na opção Parameter . 

Dê o clique no botão direito do mouse. 

Será visualizado um submenu, conforme figura adiante. 
Clique na opção Adicionar Parameter . 


SR on 


Em seguida, será visualizada a figura seguinte: 
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Adicionar Parameter 
Colar Ctrl+V 
Alterar ordem... 


Alphabetical Sort 





Page Footer 
Last Page Footer 
Summary 

No Data 
Background 





Figura 2.2: Adicionando Parameter 


No menu de propriedades, vamos configurar o parâmetro, 
conforme pode ser visto a seguir. 











E) 
Parameter Class java.lang.String vJ) 
Use as a prompt 

E) 
Properties No properties set m 








Figura 2.3: Configurando o Parameter imagemLogo 
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1. Na propriedade name , colocaremos o nome do parâmetro, 
neste caso, imagemLogo . 

2. Na propriedade parameter Class , visualizaremos uma lista 
de classes. Selecione a classe String . 


Adicione parâmetro nmSistema que será utilizada para 
mostrar o nome do sistema. 


1. Na propriedade name , vamos colocar o nome do parâmetro, 
neste caso, nmSistema . 

2. Na propriedade parameter Class , visualizaremos uma lista 
de classes. Selecione a classe String novamente. 


: Report Inspector 4 x 

ja relUF 

H-A] Styles 

E e Parameters 

oF imagemLogo 
oF nmSistema 

= Fields 

J® Variables 

=| Scriptlets 

Title 

Page Header 





EE) 


{hfe} Le} 


Column Header 
Detail 1 
Column Footer 


{+} 


Fhe} Eh 


roa M M M 


Page Footer 


Summary 








Background 


{+} 





Figura 2.4: Configurando o Parameter nmSistema 


Adicionamos e configuramos os parâmetros do relatório. Agora, 
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ele esta apto para receber parametros. O importante é que haja uma 
correspondência entre o nome dos parâmetros no iReport e o nome 
do parâmetros no HashMap passado com parâmetro para o iReport. 


Adicionando fields no relatório 


Estando na interface de desenvolvimento, no menu Report 


Inspector : 


. Clique na opção Field. 

. Dê clique no botão direito do mouse. 

. Será visualizado um submenu, conforme a figura adiante. 
. Clique na opção Adicionar Field. 


a FW HY 


. Em seguida, será vista a figura a seguir. 


Report Inspector ax. 
& relur 
+) [43] Styles 
= Parameters 
= 
+=) Sa Colar Ctrl+V 


= 
t 


Adicionar Field 


H- Tit Alterar ordem... 
S-E Pa alphabetical Sort 
+ | Coram rreoucr 

+- j| Detail 1 

[=| Column Footer 

[| Page Footer 

[=| Summary 
E No Data 
[7] Background 





[++ 





Figura 2.5: Adicionando fields 
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No menu de propriedades, vamos configurar o field. 


É oportuno lembrar de que, no nosso contexto, a fonte de dados 
será um ArrayList. Assim, o nome do atributo ( field ) deve ser o 
mesmo nome do atributo do objeto armazenado no ArrayList. Ou 
seja, deve haver uma correspondência entre o nome dos atributos da 
classe UF.java eodos fields relUF.jrxml . 


1. Na propriedade name , colocaremos o nome do field de 
id. 

2. Na propriedade Parameter Class , visualizamos uma lista 
de classes. Selecione a classe Integer . 





‘id - Propriedades I> x 

[Propriedades | 
Name id (a) 
Field Class [java.lang. Integer aA 


d 


Properties No properties set P 








Figura 2.6: Configurando o field id 


Agora, vamos adicionar outro Field . Assim, na propriedade 

name , colocaremos o nome do field de nome eo do field de 

sigla. Já na propriedade Parameter Class , visualizamos uma lista 
de classes. Selecione a classe String para ambos. 
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Page Header 
Column Header 
Detail 1 

Column Footer 
Page Footer 
Last Page Footer 
Summary 

No Data 


Background 


Figura 2.7: Configurando field nome 
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las relur 

-A Styles 
BF Parameters 
-$S Fields 





GJ Variables 
(=) Scriptiets 
H- E Tite 
-E| Page Header 
-|=| Column Header 
[| Detail 1 
[7] Column Footer 
[| Page Footer 
Last Page Footer 
Summary 
No Data 
Background 





Figura 2.8: Adicionando o field sigla 


Agora que adicionamos os parâmetros e atributos, o nosso 
relatório está apto para receber os parâmetros e atributos. 
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: Report Inspector 4 x 
a E 

H-A] Styles 

[E oF Parameters 
Pod oF imagemLogo 
i: ee oF nmSistema 
= = Fields 

is = id 

- E nome 

Aa = sigla 
Variables 
Scriptlets 

Title 

Page Header 
Column Header 
Detail 1 

Column Footer 


a a a CGC O DR 


LINHO OS 


Page Footer 





Summary 





Background 








Figura 2.9: Parâmetros e atributos adicionados 


Cabeçalho do relatório 


Vamos agora iniciar a implementação do cabeçalho. Na 
interface de desenvolvimento, no menu Report Inspector : 


1. Clique no parâmetro nmSistema . 
2. Arraste o parâmetro nmSistema paraa área Page Header . 
3. Redimensione e posicione o parâmetro nmSistema . 
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gb P{nm Sistema} D 


Figura 2.10: Adicionando o parâmetro nmSistema no cabeçalho 


Agora, no menu Paleta . 


1. Clique no componente Image . 

2. Arraste o componente Image paraa área Page Header . 

3. Quando soltá-lo na área, será disponibilizada uma tela 
conforme a figura a seguir. 
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fix -Image Expression i == 














ES Parameters numberOfLeadingZeros( int ) int 








nome Field String numberoOfTrailingZeros( int) int e 
J> Variables sigla Field String bitCount int ) int E 





{| User Defined Expressions 
C Recent Expressions 
|.) Expression Wizards 


equals( Object ) boolean 
toString( String 
toString{ int, int) String 
toString( int ) String 
hashCode() int 
reverseBytes( int ) int 


camnareToal hiert \ int 





Vx 


E 











[o [comi] 


Figura 2.11: Adicionando o componente Image no cabeçalho 














Nesta tela, são dispostas opções de seleção para associarmos ao 
componente Image . 


Então, clique na opção Parameters . Na parte inferior no 
centro, será visualizada uma lista de parâmetros. Dê um duplo 
clique na opção imagemLogo , certifique-se de que o nome do 
parâmetro imagemLogo está sendo visualizado na parte superior da 
tela, e clique no botão Ok. 
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fy, $PfimagemLogo) - Image Expression r n [mn 








$P{imagemLogo} 








E Recent Expressions 
E Expression Wizards 


SORT. FIELDS Paran 
FILTER Parameter D 
REPORT_VIRTUALIZE 


IS. IGNORE PAGINAT d 


imagemLogo Paramg 


nmSistema Paramet: + 


equals( Object ) boolean 
toString) Strina 
hashCode( int 
compareTo( Object ) int 
compareTo( String ) int 
indexOf( String, int ) int 
indexOf{ int ) int 
index0f int, int) int 





< [um] r 

















Figura 2.12: Configuração do componente Image 


Agora vamos redimensionar e posicionar o componente 
Image . 


Opcionalmente, na propriedade Image Expression do menu 
Propriedades , podemos alterar a configuração do componente 
Image . 
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$P{nmSistema} 


Figura 2.13: Alterando o componente Image 


No menu Paleta , no submenu Tools: 


1. Clique no componente Current date. 

2. Arraste-o para a área Page Header . 

3. Quando soltarmos o componente na área, será disponibilizada 
uma tela conforme vemos na figura seguinte. 
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: Paleta DD x 











4E Spider Chart [7] Table i 
E Rectangle (9 Round Rectangle 

å Sort iel Static Text — 
Subreport [T] Text Field 

= Tools 
TO callout | Currentdate | [#] Page number = 
Page X of Y | Creates a textfield to display the current date 
(=) Web Framework 

å Sort = 


Figura 2.14: Selecionando o componente Current date 


Selecione a formatação dd/mm/yyyy , e clique no botão Apply . 


tz Pattern editor z= 
Category Sample 
07/02/2015 





Time 


02/07/2015 


2015/02/07 
Sábado 07 Fevereiro 2015 
Fevereiro 07, 2015 


07/02 
07/02/15 
07-Fev 
07-Fev-15 





dd/MMiyyyy 














Figura 2.15: Definição de formatação de data 


Ainda no menu Paleta no submenu Tools , faça o mesmo 
procedimento como Static Text , clicando e arrastando-o para a 
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Page Header . 





: Paleta 








Db x 
4E Spider Chart Table 
/ Line @ Map 
tal Rectangle © Round Rectangle 
4 Sort | Re Static Text a 
E Subreport Text ; 
= Tools 


Dci (Parete iE] Poperumber = 
Page X of Y Percentage [#] Total pages 
= Web Framework 

+ Sort = 








Figura 2.16: Selecionando o componente Static Text 


1. Altere a propriedade Text do menu Propriedades para 
Relatório de UF. 


2. Redimensione e posicione o componente Static Text . 


$P{nmSistema} 


Relatório de UF 


new java.util.Date) 








Figura 2.17: Configurando o componente Static Text 


40 2.4 CRIANDO UM RELATÓRIO DE LISTAGEM 


Novamente no menu Paleta nosubmenu Tools: 


1. Clique no componente Page X of Y. 
2. Arraste-o para a área Page Header . 
3. Redimensione e posicione-o. 























: Paleta I x 
~v — 

4E Spider Chart P| Table 

4 Line E» map 

tal R [Line PE {É ] Round Rectangle 

$ Sort bel Static Text "E 
E>] subreport Text Field 

= Tools 
TO, callout F Currentdate [#|Pagenumber |F 
i Page X of Y | Percentage [É | Total pages 

=| Web Framework 

* Sort Es 


4 


Figura 2.18: Adicionando o componente Page X of Y 


Agora, apenas no menu Paleta , faça o mesmo para o 


componente Line : clique, arraste para Page Header e posicione- 
o. 
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$P{nmSistema} new java.util. DateQ 


Relatório de UF "Page "+V" "+ $V 


Bann ë O 


Column Header 


Figura 2.19: Adicionando o componente Line 


Assim, concluímos a implementação do cabeçalho. 


Detalhe do relatório 


Na área Detail , colocamos os fields que serão mostrados 
no relatório. Vá para o menu Report Inspector : 


1. Clique na opção fields. 

2. Clique em field id. 

3. Arraste-o para área Detail , redimensionando e 
posicionando-o. 

4. Será disponibilizado um componente Static Text na área 
Column Head com o nome da coluna já definido. 
Opcionalmente, podemos alterá-lo. 

5. Clique no Label id na área Column Head e, em seguida, 
altere a propriedade Text do menu Propriedades para 
Código . 
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$P{imagemLogo} new java.util.Date() 


Relatório de UF "Page"+$V ""+$V 


val 


Figura 2.20: Adicionando o field id no detalhe do relatório 


Agora que você já aprendeu a adicionar um field 
relatório, adicione os demais field, o do nome e da sigla. 
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no 
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$P{imagemLogo} new java.util.Date() 





Relatorio de UF "Page "+$V "+ $V 
Codigo nome 
SFfid} $F{nome} 
Detail 1 


Figura 2.21: Adicionando o field nome no detalhe do relatório 


Novamente no menu Paleta: 


1. Clique no componente Line. 
2. Arraste-o para área Column Head . 
3. Redimensione e posicione o componente. 
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$P{imagemLogo} new java.util DateQ) 


Relatório de UF "Page +$V ""+$V 


eo 














Codigo nome sigla 
§-—__-—_- #4 
$F{id} $F{nome} $F{sigla} 














Figura 2.22: Adicionando o componente Line 


Na área Column Head , clique no label Código . Serão 
disponibilizadas para configuração as suas propriedades. Para 
imprimir em negrito, marque a opção Bold. 








<| 


DaT 





Strike Through 


Unaricantal A ianmant 


Bold ag 


b 
> 








Figura 2.23: Configurando o label Código 
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Para que todos os label tenham a mesma altura, temos as 
seguintes opções: 


1. Configurar visualmente arrastando os labels e colocando 
todos na mesma altura. 

2. Clique em cada label e, na propriedade Top do menu 
Propriedades , atribua o mesmo valor a todos. 




















: Código - Propriedades > : 
= Propriedades À 
Left 11 : 
| 
Width 82 

Height 20 

Forecolor E [0,0,0] f) 
Backcolor El [255,255,255] P 
Opaque 

Style =|” 
Top es 


Top position of this element in the band/frame/cell. 


Figura 2.24: Configurando a propriedade Top do label 


Fazemos o mesmo processo para colocar todos os fields na 
mesma altura, assim como fizemos com os labels: ou configuramos 
visualmente, ou também clicamos em cada field e, na propriedade 

Top do menu Propriedades , atribuímos o mesmo valor para 
todos. 
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$P{imagemLogo} new java.util.Date() 





Relatório de UF "Page "+8V ""+$V 
Código Nome Sigla 
SFI * E ses 





Figura 2.25: Configurando a propriedade top dos fields 


Dessa forma, concluímos a implementação. Agora, é preciso 
compilar. Para isso, clique na figura do martelo do lado do nome da 
fonte. Na parte inferior na aba Report output , podemos 
visualizar o caminho completo onde foi gerado o arquivo 

relUF. jasper . Agora é só testar a execução do relatório de UF. 
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Aar] eB; 




















[Bese] m Prevew |S a A |P [Sse o JAn] b ilus=eezse 
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E 
le 

J SPE magemLogo} new java.util. Datel) 

4 
é Relatório de UF “Page sy "+ sy 

E la 

J digo Nome Sigla 
i $F{id) $F {nome} $F (sigha) | 
É = 

| 

os 

| 
É 

= 

3 

LE 
|: Report Problems Window |: iReport output 





Report console] Finished [relUF jemi] | 
© Compiling to file... CAMauriciovreportiRelatoriorelUF jasper 
Compilation running time: 3.120! 








Figura 2.26: Compilando o relatório 


2.5 CRIANDO RELATÓRIO COM 
AGRUPAMENTO 


Layout do Relatório 


Nosso desafio agora é implementar o relatório com 
agrupamento por unidades federativas, conforme o layout mostrado 
na figura a seguir. 


48 2.5 CRIANDO RELATÓRIO COM AGRUPAMENTO 











SISTEMA DE GERENCIAMENTO DE CLIENTE 07022015 

© DEV ELOPEN 
Fagna 1de 1 
Relatorio de Município 

UF Ceara 
Codigo Nome População 
4 aquiraz so 
1 fortaleza 100 
5 juazero so 
Media Populacional 76,67 Tots! 230 
UF Filo de janeiro 
Codigo Nome População 
2 no de janero 200 
Medis Popuisciona! 200,00 Tots 200 
UF Sac Pawo 
Cédigo Nome População 
3 530 pauo 300 
Media Popuisciona! 300,00 Tots! 300 


Figura 2.27: Layout do relatório 


O relatório é composto de um cabeçalho, que contém: 


Gi ee Ge 


Uma imagem com o logo da empresa; 
O nome do sistema; 

A data de impressão; 

Contador de páginas; 

O nome de relatório. 
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Em seguida, temos um agrupado por unidades federativas e uma 
área reservada para colocar o nome das colunas do relatório. Temos 
também uma área detalhada com as informações do Município 
pertencente à unidade federativa, e, finalmente, uma área reservada 
para as variáveis que vão calcular a média populacional e o total da 
população da unidade federativa. É oportuno lembrar de que os 
valores da população não reflete a realidade, são meramente 
didáticos. 


Adicionando Parameters, Fields e Cabeçalho no 
relatório 


Já sabemos como adicionar parâmetros, fields e implementar o 
cabeçalho do relatório. Se ainda persistir alguma dúvida sobre esses 
temas, retorne à seção Criando um relatório de listagem. O que 
veremos de diferente aqui será como adicionar grupo e variáveis. 


Gostaríamos apenas de enfatizar que a classe Municipio.java 
possui um atributo do tipo UF. java . Observe que adicionamos os 
fields: uf.id e uf.nome. 
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: Report Inspector 4 x 





lea. relMunicipio 

H-A] Styles 

a oe Parameters 
nmSistema 
imagemLogo 





+ e ceil 
| do = ufid 

E fx Variables 
ET) Scriptiets 
I Title 

I Page Header 
-=| Column Header 
[=| Detail 1 
-=| Column Footer 
[| Page Footer 
[| Last Page Footer 
ies [=| Summary 

se fm] No Data 
H- E| Background 





Figura 2.28: Ênfase no field UF 


Adicionando Grupo 


Neste relatório, vamos criar um grupo para que possamos 
totalizar a população por unidade federativa e também obter uma 
média da população por unidade federativa. 


No menu Report Inspector : 
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1. Clique na opção do nome do relatório; no nosso contexto, em 
relMunicipio . 

2. Clique no botão direito do mouse para visualizar o submenu. 

3. Clique na opção Add Report Group. 

4. Será disponibilizada uma tela conforme a figura a seguir. 


: Report Inspector axl E relMunicipio.jrxml x 
“SET “ee i 

















H-A] Styles Page format... 

E: oF Param Remove Report Margins potiris 

H- Fields 

a) Variab Compile Report | 

E Script 5 | 

G-E] Tite | Propriedades 

| Pageh Edit Query | 

fH [7] Colum | 
|F| Detail Add Report Group 

-ml sae) Add Dataset | 

i Page Colar Ctrl+V 

+- E| Last P 

H- [E| Summ, Open Report Folder in Favorites 

i- [EB] No Date T 

H- E| Background E 


Figura 2.29: Adicionando Grupo 


Nesta tela, configuramos o grupo colocando o nome de UF , 
agrupado por uf.id. 
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Ry New group wizard 


x 








Passos Group criteria 
1. Group criteria 
2. Details 
Group name 
UF 


@ Group by the following report object: 























| uf.id Field Integer X ] 
© Group by the following expression: 
(2) 
< Voltar Finalizar Ajuda 
Figura 2.30: Configurando Grupo 
Como as opções group header e group footer estão 


marcadas, elas serão adicionadas ao relatório. Depois, clique no 


botão de finalizar. 
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tx New group wizard [pee Soom] 








F 
Ê 


























< Voltar “Próximo > [raza e] Cancelar ] ajuda 





Figura 2.31: Finalizando configurando do Grupo 


Criando variáveis no relatório 


No menu Report Inspector , clicando na opção variables , 
as variáveis são disponibilizadas. O iReport já disponibiliza 5 
variáveis nativas. 


e PAGE NUMBER 

e COMMLUM NUMBER 
e REPORT COUNT 

e PAGE COUNT 

e COMMLUM COUNT 


Agora, no menu Report Inspector : 


1. Clique na opção variables . 

2. Clique no botão direito do mouse para visualizar o submenu. 
3. Clique na opção Add variable . 

4. Será adicionada uma variable conforme a figura a seguir. 
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ja relMunicipio 

H-A] Styles 

RE Parameters 

&-& Fields 

m f ba Adicionar Variable 
jon JR Colar Ctrl+V 
je Jx | Alterar ordem... 
~J*| Aiphabetical Sort 
= JX Cocor cour 

H- Scriptlets 

G- [7 Title 

&)--[P| Page Header 

E) [=| Column Header 

i- E| Detail 1 

-P| Column Footer 

&--[7| Page Footer 

H- Last Page Footer 

H- E| Summary 

i- il No Data 

-j| Background 





Figura 2.32: Selecionando adicionar variáveis 


Nesta tela, vá para o menu Propriedades e configure a 
variable . 


e Na propriedade Name , altere para totalPopulacao . 

e Na propriedade Variable Class , é disposta uma lista 
de classe. Selecione a classe Integer . 

e Na propriedade Calculation , é disponibilizada uma 
lista de cálculo. Selecione a opção sum . É oportuno 
lembrar de que essa propriedade somará a população 
dos municípios cadastrados. 

e Na propriedade Reset Type , é apresentada uma lista 
de Reset . Selecione a opção Group . 


2.5 CRIANDO RELATÓRIO COM AGRUPAMENTO 55 


e Na propriedade Reset Group , selecione a opção UF. 


As propriedades Resset Type e Reset Group determinam 
que, sempre que uma variável mudar de unidade federativa, ela será 
inicializada. 











Reset group 
Increment type 





Increment group | x| 
Incrementer Factory Class (ws) 
Variable Expression (as) 
Initial Value Expression (æ) 


Figura 2.33: Configurando variável totalPopulacao 


Vamos, agora, adicionar mais uma variável. Para isso, vá para o 
menu Propriedades econfigurea variable da seguinte forma: 


1. Na propriedade Name , altere para mediaPopulacao . 
2. Na propriedade variable Class , é disponibilizada uma 
lista de classe. Selecione a classe Double . 
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3. Na propriedade Calculation , é fornecida uma lista de 
cálculo. Selecione a opção average . É válido lembrar de que 
essa propriedade calculará a média da população da unidade 
federativa. 

4. Na propriedade Reset Type , é apresentada uma lista de 

Reset . Selecione a opção Group . 
5. Na propriedade Reset Group , selecione a opção UF. 


Como já visto, as propriedades Resset Type e Reset Group 
determinam que, sempre que uma variável mudar de unidade 
federativa, ela será inicializada. 


: mediaPopulacao - Propriedades >» x 
= Propriedades 

Name mediaPopulacao (em 
Variable Class java.lang.Double vi 
Calculation Average m 
Reset type Group pe 
Reset group E v 


increment group 
Incrementer Factory Class 
Variable Expression 

Initial Value Expression 


[u 
increment type [None v 
[us 
(= 
” 


Figura 2.34: Configurando variável mediaPopulacao 
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Como já aprendemos anteriormente, não vamos repetir o 
processo de adicionar e configurar fields e labels. Se ainda persistir 
alguma dúvida, retorne à seção Criando um relatório de listagem. 


Gostaria apenas de enfatizar que as informações da unidade 
federativa e os labels das colunas do relatório ficam na área UF 
Group Header . Assim, arraste as variáveis que adicionamos para a 
área UF Group Footer . 


| 


| 


$P{nmSistema} new java.util.Date 


"Pagina" + $V ™ + $V 
Relatorio de Municipio 


| UF $F{uf.nome} 

] z 

] Codigo Nome Populacao 

| $F{id} $F{nome} $F{populacao} 

] Média $V{mediaPopulacao} Total $V{totalPopulacao} 
1 


Figura 2.35: Finalizando design do relatório 


Concluímos a implementação, mas precisamos compilar. Para 
isso, clique no martelo do lado do nome da fonte. Então, na parte 
inferior na aba Report output , podemos visualizar o caminho 
completo em que o arquivo relMunicipio.jasper foi gerado. 
Agora é só testar a execução do relatório de Município. 
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T& reMuncpo. jon x ERC] E 
[Dm] ma sown lea diem Sans >; inalbiusrzazxazse 
ml, saakaas A tr sadias AA were | | [Compile Repor), rt bie =. alas RR | 
I 
- 
be 
d $P(nm Sistema) nen java util Dated 
E “Pagina” + $V" + $V 
=| Retatorio de Municipio 
FE 
3 uF SF (ut. neme) 
- Código Nome Populacac 
be 
q sF(id) SF(nome) SFipopulacac) 
o= i 
qJ Meda SufmediaPopulacao) Total SuftotalPopulacao) 
jE 
3 
= 
E 
E rn = = 
E Report Problems window iReport output 





Report console | | Finshed [reMuniopo.jrxmi] | 


© Compiling to file . C\MauriciovreportiRelatoriovrelMunicipio jasper 
Compilation running time: 3.784! 





Figura 2.36: Compilando relatério 


2.6 CONCLUSAO 
Neste capitulo aprendemos a: 


e Adicionar as libs necessárias para executar o relatório 
em uma aplicação Java. 

e Implementar o método necessário para disponibilizar o 
relatório no formato PDF. 

e Adicionar e configurar Parameters, Fields e Variables. 

e Implementar um relatório de listagem usando como 
fonte de dados ArrayList. 

e Implementar um relatório com agrupamento usando 
como fonte de dados ArrayList. 


No próximo capítulo, vamos aprender a implementar estes 
mesmos relatórios usando com fonte da dados instrução SQL. 
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CaríTULO 3 


RELATORIO COM SQL 


3.1 CRIANDO RELATORIO DE LISTAGEM COM 
SQL 


Layout do relatório 


Nosso desafio será implementar o relatório de unidade 
federativa conforme mostra a figura a seguir, que criamos 
anteriormente utilizando como fonte de dados ArrayList. Porém, 
desta vez, em vez de usar ArrayList, usaremos instrução SQL. 











SISTEMA DE GERENCIAMENTO DE CLIENTE 07/02/2015 
a) DEVELOPER 
Pagina 1 de 1 
Relatorio de UF 
Codigo Nome Sigla 
8 Acre AC 
3 Ceara CE 
6 Maranhao MA 
7 Piaui PI 
4 Rio de janeiro RJ 
5 Sao Paulo SP 


Figura 3.1: Layout do relatório 


Método gerarRelatorio 
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Na classe AbstractMB , adicionamos o método 
gerarRelatorio . Este método é similar ao que vimos no capítulo 
anterior. A diferença é que ele não utiliza ArrayList, mas sim uma 
conexão JDBC (Java Database Connectivity). 


O método gerarRelatorio é responsável pela execução e 
visualização do relatório, e também por acrescentar parâmetros 
comum a todos os relatórios, como por exemplo imagemLogo . 


Instanciamos a classe HttpServletResponse para que o 
usuário possa visualizar o relatório. 


public void gerarRelatorio(String nomeRelatorio, 
HashMap paramRel) { 
FacesContext context = FacesContext.getCurrentInstance(); 

HttpServletResponse response = 

(HttpServletResponse) context.getExternalContext() 
.getResponse(); 

ServletContext sc = 

(ServletContext) context.getExternalContext().getContext(); 


String relPath = sc.getRealPath("/"); 
String imagemLogo = 

relPath + "resources/imagens/logo_mmo.jpg"; 
paramRel.put("imagemLogo", imagemLogo); 
paramRel.put("nmSistema", Constants.NOME SISTEMA); 
paramRel.put ("REPORT LOCALE", new Locale("pt", "BR")); 


Instanciamos a classe Connection , que é utilizada para fazer a 
conexão com o banco de dados, e a classe JasperFillManager 
gera o relatório. 


try { 

JasperPrint print = null; 

String url = "jdbc:postgresql://localhost :5432/sgc"; 

String user = "postgres"; 

String pass = "123456"; 

Connection connection = 
DriverManager.getConnection(url, user,pass); 

print = JasperFillManager.fillReport(relPath + 
"relatorios/"+nomeRelatorio+".jasper", 
paramRel, connection); 
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Com o relatório criado, configuramos o objeto response para 
mostrar o relatório no formato «pdf . A classe 
JasperExportManager exporta o objeto print para pdf. 


response. setContentType("application/pdf"); 
response. addHeader ("Content -disposition", "attachment; 
filename=\"" + nomeRelatorio + ".pdf\""); 
JasperExportManager .exportReportToPdfStream(print, 
response. getOutputStream()); 
ServletOutputStream responseStream = 
response. getOutputStream(); 
responseStream.flush(); 
responseStream.close(); 
FacesContext.getCurrentInstance().renderResponse(); 
FacesContext.getCurrentInstance().responseComplete(); 
} catch (Exception e) { 
e.printStackTrace(); 


} 


Classe UFMB 


Na classe UFMB , adicionamos o método relatorio , que sera 
responsável pela preparação dos parâmetros do relatório e pela 
chamada do método gerarRelatório . Um dos parâmetros 
passados é o nome do relatório que deve ser visualizado. Como o 
objetivo é um relatório com SQL, neste método não é feita nenhuma 
consulta e também não é passado nenhum ArrayList. 


public class UFMB extends AbstractMB { 
public void relatorio() throws Exception { 


try { 
HashMa p paramRel = new HashMap(); 
String nomeRelatorio = "relUF"; 


gerarRelatorio(nomeRelatorio, paramRel); 
} catch (NegocioException e) { 
addMsgErro(e.getMessage()); 


} 


Para iniciar a configuração da conexão, na tela principal da 
IDE , clique na figura do lado da palavra Empty datasource para 
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ser disponibilizada uma tela de configuração, conforme mostra a 


figura seguinte. 





Arquivo Editar Exibir Preview Janela Ferramentas Ajuda 


S&S XB DE g [Erodas "4 


Figura 3.2: Interface de desenvolvimento 





Na tela Connections / DataSources , clique no botão New e, 
depois, avance para a tela seguinte. Veja a figura a seguir: 


ft Connections / Datasources 


Name Datasource type Default 
Empty datasource pty data source [7] 
Sample Database (HS... Sample Database Co... F 






































Figura 3.3: Connections/DataSources 


Na tela DataSource , será apresentada uma lista de 
DataSource . Selecione a opção Database JDBC connection e 
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clique no botão Next . 


tr - 


Datasource 
Select the datasource type 
Database JDBC connection 
NetBeans Database JDBC connection 
XML file datasource 
JavaBeans set datasource 
\File CSV datasource 
JRDataSourceProvider 
Custom JRDataSource 
[Empty data source 
|Hibernate connection 


Spring loaded Hibernate connection 
EJBQL connection 

XMLA Server 

|Mondrian OLAP connection 

Query Executer mode 

Microsoft Excel (xls) data source 
Microsoft Excel 2007 (xlsx) data source 
\MongoDB Connection 

[Remote XML file datasource 

JSON datasource 

Sample Database Connection 
|Hadoop Hive Connection 


























ve) Ce 


Figura 3.4: DataSources 


A tela Database JDBC connection é onde informamos os 
dados da conexão, conforme mostra a figura a seguir. É oportuno 
lembrar que o username e o password são os que você usou para 
configurar o seu banco de dados PostgreSQL. 
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ES 





a 


n 


ome 
“= Database JDBC connection 





Name 


3 





JDBC Driver PostgreSQL (org.postgresql.Driver) 


JDBC URL (jdbc:postgresql://localhost:5432/sgc 


Credentials 
Username postgres 


Password leccese 

















ATTENTION! Passwords are stored in dear text. If you dont specify a 
A Password now, iReport will ask you for one only when required and will not 


save it. 








Figura 3.5: Database JDBC connection 


Após terminar a configuração, clique no botão Test para 


verificar se a conexão foi configurada com sucesso, como 
verificamos na figura adiante. Se a conexão foi configurada com 


sucesso, clique no botão Save . 
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C 


ome 4 
>= Database JDBC connection 


Name (sgc 





JDBC Driver PostgreSQL (org.postgresql.Driver) X 
JDBC URL jdbc:postgresql: [Nocalhost:5432/sgc 


Credentials 
Username postgres 


Password eseses 





[V] Save password 


ATTENTION! Passwords are stored in clear text. If you dont specify a 
_ password now, iReport will ask you for one only when required and will not 
save it. 














Figura 3.6: Sucesso no teste de conexão 








Na tela Database JDBC connection , caso haja a necessidade 
de alterar a configuração do datasource sgc , basta um clique na 
opção sgc,e o botão Modify será habilitado. Em seguida, clique 
neleeatela Database JDBC connection será disponibilizada para 
alterar a configuração. 


Já se houver a necessidade de excluir a configuração, basta um 
clique na opção sgc eo botão Delete será habilitado. Ao clicar 
nele, ela será excluída. 
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fy, Connections / Datasources 











Name Datasource type Default 


Empty datasource pty data source | 
Sample Database (HS... Sample Database Co... 
sgc Database JD O 
































Clo 








Figura 3.7: Selecionando conexão sgc 


Agora que já criamos a conexão, vá para a tela principal da IDE 
e clique na figura do lado da palavra preview . Será disponibilizada 
uma tela, como verificamos na figura a seguir: 


3.1 CRIANDO RELATÓRIO DE LISTAGEM COM SQL 67 


IA relUFSQL.jrxmi x 
XML Preview IS Q = EEE San + 


0 1 mi 

















Figura 3.8: Selecionando a opção Report query 


Na tela Report query , visualizamos diversas opções de 
Datasource . Selecione a opção de Report query e, em Quary 
language , veremos as diversas opções de linguagens. Clique na 
opção SQL , conforme mostra a figura a seguir. 


S Report query 








Report query | JavaBean Datasource T DataSource Provider | CSV Datasource | Excel Datasource 
Query language SQL] 








Figura 3.9: Selecionando a opção Query language 
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Assim, criamos a nossa instrução de consulta à tabela UF e, 
simultaneamente, os fields do relatório são criados. 


hy Report query 








Report query | JavaBean Datasource | DataSource Provider | CSV Datasource | Excel Datasource 











Query language SQL = 


SELECT CODIGO_UF, NOME, SIGLA 
FROM UF 











Figura 3.10: Script SQL 


Load Query 


Outra forma de criarmos nossa instrução SQL é quando criamos 
a instrução previamente e salvamos em uma pasta. Na tela Report 
query , clique no botão Load Query e será disponibilizada uma 
tela conforme mostra a figura a seguir. Selecione o arquivo na pasta 
onda está o arquivo e clique em abrir. 


Conforme o arquivo selecionado, a instrução será criada 
simultaneamente aos fields do relatório. 
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peguem: | sa Jara 








LJ relUFSQL.sql 














| ta Nome do arquivo: = |relUFSQL.sql | 
[ cancer ] 


Arquivos do tipo: [SQL query (*.sql, *.bxt) x 











Figura 3.11: Selecionando script na pasta 


Na tela Report query , clique no botão New Parameter para 
a tela de adicionar parâmetros ser exibida. Será nela que vamos 
adicionar os parâmetros do nosso relatório, conforme mostra a 
figura a seguir. 


pis x 
thy, Add parameter 











te (java.util. Date) 
te/Time (java.sql. Time) 


te Range (net.sf.jasperreports. types. date .DateRange' 
ime Range (net.sf.jasperreports. types.date. TimestampR 








Figura 3.12: Adicionando parametro 


70 3.1 CRIANDO RELATÓRIO DE LISTAGEM COM SQL 


Após criar a instrução SQL e os parâmetros do relatório, clique 
em OK para sair datela Report query. 


hy Report query 














Report query | JavaBean Datasource | DataSource Provider | CSV Datasource | Excel Datasource | 


Query language SQL v 


SELECT CODIGO_UF, NOME, SIGLA 
FROM UF 














Figura 3.13: Report query finalizado 


Retornando à tela principal da IDE , verifique que os 
parâmetros e os fields já estão criados. Agora é só desenhar o 
relatório conforme já foi visto anteriormente. 


3.1 CRIANDO RELATÓRIO DE LISTAGEM COM SQL 71 


: Report Inspector 4 x 
lai reluFsQL 
H-A] Styles 
Re Parameters 
; pore e imagemLogo 
i.. RE nmSistema 
=)-S Fields 
ba = codigo_uf 
> S nome 
À -S sigla 
Gf Variables 
-1 Scriptlets 
Title 
Page Header 


tt} 


Column Header 
Detail 1 
Column Footer 


EEE) 


EERE 


Page Footer 


E 


Summary 








Background 


EL eee 





Figura 3.14: Parâmetro e fields adicionados 


Após o término do desenho do relatório, é só compilar e testar 
na aplicação. Como se trata de uma fonte de dados Report query, 
outra forma de testar é dando um clique na aba preview . Assim, 
será disponibilizada uma tela para informar a localização do 
parâmetro imagemLogo , como verificamos na figura adiante. 
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thy, Parameter prompt (premio 


dB You can provide a value for the parameter. 


imagemLogo 
c:Vogo mmo.jpg| X 
The class type is:java.lang.String 








(Cae 


Figura 3.15: Informa path do parametro imagemLogo 








Depois, será exibida uma tela para informar o parâmetro Nome 
do Sistema. 





r à 
R Parameter prompt (s=) 
dB You can provide a value for the parameter: 
nmSistema 
Sistema de Gestão de Cliente| +, 


The class type is:java.lang.String 





(oe) (ae 


Figura 3.16: Informa nome do sistema 








Finalmente, o relatério sera visualizado. 
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Sistema de Gestão de Cliente 10/02/2015 


ra) DEVELOPER 
Relatório de UF Page 1 of 1 

codigo uf nome sigla 

6 Maranhao MA 

8 Acre AC 

3 Ceara CE 

ti Piaui PI 

4 Rio de janeiro RJ 

5 Sao Paulo SP 


Figura 3.17: Preview do relatório 


3.2 CRIANDO RELATORIO COM SQL E COM 
PARAMETRO 


Layout do Relatorio 


Nosso desafio será implementar o relatório de unidade 
federativa, como visto na figura adiante, que criamos no tópico 
Criando relatório de listagem com SQL . Porém, desta vez, 
vamos acrescentar uma cláusula where na instrução SQL e vamos 
passaro id da UF como parâmetro. 
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SISTEMA DE GERENCIAMENTO DE CLIENTE 07/02/2015 
@ DEVELOPER 








Pagina 1 de 1 
Relatorio de UF 
Codigo Nome Sigla 
8 Acre AC 
3 Ceara CE 
6 Maranhao MA 
7 Piaui PI 
4 Rio de janeiro RJ 
5 Sao Paulo SP 


Figura 3.18: Layout do relatório 


Classe UFMB 


No método relatorio, passamoso id da UF que será usado 


na where da nossa instrução SQL do relatório que vamos criar. 


public void relatorioSQLCP() { 
HashMap paramRel = new HashMap(); 
if (uf.getId() > 0) { 
paramRel.put("codigo",uf.getId()); 
} 
String nomeRelatorio = "relUFSQLCP"; 
gerarRelatorio(nomeRelatorio, paramRel); 


Na linha 4, só é criado o parâmetro se o id da UF for 


informado. 


Na tela Report query , clique no botão New Parameter para 


adicionar o parâmetro codigo . Já aprendemos no livro a adicionar 


os parâmetros imagemLogo e nmSistema no capítulo anterior. 
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Pas id 
hy Add parameter exe 





Parameter name 























Figura 3.19: Adicionar parâmetro 


Criamos, então, a instrução SQL e colocamos a where , como 


mostra a figura a seguir: 





= 


= 
fx, Report query = = a ë = & = = i 
Report query | JavaBean Datasource | DataSource Provider | CSV Datasource | Excel Datasource 


Query language [SQL -l 























SELECT CODIGO_UF, NOME, SIGLA 
FROM UF 
WHERE CODIGO_UF = 


Figura 3.20: Criando instrução SQL 


Em seguida, clique no parâmetro codigo œ arraste para 
where da nossa instrução SQL. Veja a seguir: 
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E 
hy Report query 





Report query | JavaBean Datasource | DataSource Provider | CSV Datasource | Excel Datasource 








Query language SQL X 


SELECT CODIGO UF, NOME, SIGLA 
FROM UF 
WHERE CODIGO UF = $P{codigo} 











Figura 3.21: Definindo where 


Retornando para a tela principal da IDE , verifique que os 
parâmetros e os fields já estão criados. Agora é só desenhar o 
relatório conforme já foi visto anteriormente. 


fa $P(nmSistema) new java.util.Date() 
o i 
Relatório de UF "Page "+$\" " + $V 
codigo_uf nome sigla 
$F{codigo_uf} $F{nome} $F{sigla} 


Figura 3.22: Desing do relatório 


Após o término da implementação do relatório, é só compilar e 
testar na aplicação. Outra forma de testar, como já aprendemos, é 
dando um clique na aba preview . Será disponibilizada a tela para 
informar a localização do parâmetro imagemLogo , o nome do 
sistema e o código da UF a ser exibida. 
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thy, Parameter prompt axe 


BB You can provide a value for the parameter: 


codigo 
3 X 
The class type is:java.lang.Integer 





= Gee 


Figura 3.23: Informe código 











Finalmente, o relatério sera visualizado. 


s Sistema de Gestão de Cliente 11/02/2015 
i DEVELOPER 
Relatório de UF Page 1 of1 
codigo uf nome sigla 
3 Ceara CE 


Figura 3.24: Preview do relatório 


3.3 CRIANDO RELATÓRIO COM SQL E COM 
AGRUPAMENTO 


Layout do relatório 


Agora, nosso desafio será implementar o relatório de município 
conforme mostra a figura a seguir, que criamos anteriormente 
usando ArrayList como fonte de dados. Porém, desta vez, vamos 
criar o relatório com agrupamento utilizando como fonte de dados 
instrução SQL. 
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SISTEMA DE GERENCIAMENTO DE CLIENTE 07022015 


© DEV ELOPEN 
Fagna 1de i 
Relatorio de Município 
UF Ceara 
Codigo Nome População 
+ aquiraz so 
1 fortaleza 100 
5 juazero so 
Medis Popuisciona 76,67 Tots! 230 
ur Flo de janeiro 
Codigo Nome População 
2 ro de janeiro 200 
Media Popuisciona 200.00 Total 200 
UF Sac Pawo 
Codigo Nome População 
3 530 pawo 300 
Media Populsciona! 300,00 Tots! 300 


Figura 3.25: Layout do relatório 


Após criar o relatório, crie um grupo assim como vimos na 
seção Criando relatório com agrupamento do capítulo anterior. Em 
seguida, vá para a tela Report query e crie a instrução SQL. 


Veja que não é preciso criar uma instrução SQL com funções de 
agrupamento e nem com group by . Uma instrução simples e 
trivial já atende às nossas necessidades. Após criar a instrução SQL, 
crie os parâmetros do relatório, e clique em OK para sair da tela 
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Report query. 


thy, Report query 














Report query | JavaBean Datasource | DataSource Provider | CSV Datasource | Excel Datasource 








Query language SQL X 

SELECT uf.codigo_uf,uf.nome nome_uf,mun.codigo municipio, mun.nome,mun.populacao 
from uf uf 

inner join municipio mun 

on uf.codigo_uf = mun.codigo uf 

order by uf.nome 








Figura 3.26: Criando instrução SQL 


Após retornar para a tela principal da IDE, crie as variáveis e 
faça o design do relatório, conforme vimos anteriormente. 


Após o término da implementação do relatório, é só compilar e 
testar na aplicação. Não se esqueça da outra forma de testar dando 


um clique na aba preview. 





$P{nmSistema} new java.util. DateQ) 


Relatorio Municipio SQL "Page "+$W"" + $V 


UF $F{nome_uf} 

codigo_municipio nome populacao 

$F $F{nome} $F{populacao} 
Media $V{media} Total Populagao $V{totalPopulacao} 


Figura 3.27: Design do relatório 
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3.4 CONCLUSAO 


Neste capitulo, aprendemos a: 


e Implementar um relatório de listagem usando como 
fonte de dados instrução SQL. 

e Implementar um relatório com agrupamento usando 
como fonte de dados instrução SQL. 

e Testar o relatório utilizando o Preview do iReport. 

e Implementar o método necessário para gerar um 
relatório usando uma conexão com banco de dados. 


No próximo capítulo, aprenderemos a implementar relatório 
usando gráfico. 
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CAPÍTULO 4 


RELATÓRIO COM 
GRÁFICO 


4.1 CRIANDO RELATÓRIO COM GRÁFICO DE 
PIZZA 


Layout do relatório 


Nosso desafio agora será implementar um relatório com um 
gráfico, pois faz parte do nosso cotidiano fazer este tipo de relatório. 
Quando lidamos com porcentagem e frações, o gráfico que será 
implementado é em forma de pizza, em que cada fatia representa a 
população de um município, ou relatórios financeiros onde cada 
fatia representa o faturamento do mês. 


SISTEMA DE GERENCIAMENTO DE CLIENTE 12/11/2015 
a DEVELOPER 


Página 1 de 1 
Relatório de Município Gráfico 




































































@ AQUIRAZ @ FORTALEZA © GUARAMIRANGA © JUAZEIRO DO NORTE ® QUIXADA 
O RIO DE JANEIRO O SÃO PAULO 


Figura 4.1: Layout do relatório 
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Classe MunicipioMB 


Na classe MunicipioMB , adicionamos o método relatorio , 
que será responsável pela chamada da consulta, pela preparação dos 
parâmetros do relatório e pela chamada do método 

gerarRelatório . Um dos parâmetros passados é o nome do 
relatório que deve ser visualizado. No nosso caso, demos o nome de 
relMunicipio . 


public class MunicipioMB extends AbstractMB { 
public void relatorio() throws Exception { 


try { 
List<UF> listagemResultado = municipioDao.consulta(uf) 


HashMap paramRel = new HashMap(); 
String nomeRelatorio = "relMunicipio"; 
gerarRelatorio(nomeRelatorio, paramRel, 
listagemResultado); 
} catch (NegocioException e) { 
addMsgErro(e.getMessage()); 


Municipio.xhtml 


Na página Municipio.xhtml , incluímos um botão da tag 
PrimeFaces para iniciar a execução do relatório. 
<p:commandButton 

value="Relatório" ajax="false" 

actionListener="#{municipioMB. relatorio}"> 
</p:commandButton> 

Após criarmos os parâmetros, os fields e o cabeçalho, e 
inibirmos todas as áreas do relatório deixando bem dimensionada 
apenas a área Summary , conforme mostra a figura a seguir, vamos 
para o submenu Report Elements. 
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$P{nmSistema} new java.util. Dated) 


"Pagina" + $V" + $V 
Relatório de Município Gráfico 





Figura 4.2: Iniciando relatório 


No submenu Report Elements , clique no componente 
Chart earraste-o para a área Summary . 











: Paleta I> x 
= Report Elements a 
H Break [E] Chart 

[5] Crosstab O char = 
Frame [Ea] Html 

[R] Image [ill] Barcode 

8 Generic Element 2 List 

4E Spider Chart M] Table 

J Line E Map 











Band height 208 
Print When Expression (a) 
Split Type Stretch v 


Figura 4.3: Adicionando Chart 
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Ao soltar o componente Chart na área Summary , será 
disponibilizada uma tela com diversos tipos de gráficos, como 
verificamos na figura adiante. Clique no gráfico de pizza e, depois, 
no botão OK. 
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Chart info 














Figura 4.4: Selecionando o gráfico 


Será disponibilizada uma tela de wizard para configuração do 
componente Chart . Na opção Dataset , mantenha selecionado 
Main report dataset , clique no botão próximo e avance para a 
tela seguinte. 
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thy, Pie/Pie3D Wizard = 


Passos Dataset 








To fill this chart you can use the main dataset of 
the report, or a sub-dataset if you have defined 
one. 





57 You can even specify special rules to collect the 
data for the chart later using the Chart Data 
dialog. 


Now please select the dataset to use. 


al | 


| = 























Figura 4.5: Configurando Chart 


Nesta tela, inicialmente configuraremos a propriedade unique 
identifier . Clique no botão localizado na extremidade da direita, 
da area de input da propriedade unique identifier . 


thy, Pie/Pie3D Wizard = 


Passos Keys and values 




















ist 


To create a Pie chart you need to set which is the 
identifier of each slice and the slice value. 














To create a Pie chart, you have to provide an expression to be used as unique identifier for each slice. The 
expression cannot be null or return a null value. By default this key will be used as label for the slice as well, 

E E3) 
The size of each slice is defined by a numeric value. Provide here the expression that represents the value 
of the slice. 























ni ai 


~ | @ Please specify a valid Key expression 
aa) [om] [re Aus 


Figura 4.6: Configurando unique identifier 














Será disponibilizada uma tela conforme mostra a figura a seguir. 
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Selecione fields e clique duas vezes na opção do field nome 
Depois, clique no botão apply . 


ha Expression editor tS 


[SFfnome) 



























Ln 1, Col 8 
id Field Integer equals( Object ) boolean a 
tostring0 ses E 
J* Variables uf.nome Field String hashCode( int 
E a = Express populacao Field Long compareTo( Object ) int 
= Recent essions 
- oo É uf.id Field Integer compareTo( String ) int 
E Expression Wizards 
indexOf{ String, int ) int 
indexOf( int ) int 
indexOf{ int, int) int 
= : indexOf{ String ) int É 
Ta Y% «| — ] + 

















Figura 4.7: Selecionando field nome 


Faremos o mesmo processo para configurar a propriedade 
numeric value . Clique no botão localizado na extremidade 
direita da área de input da propriedade. 


Será mostrada uma tela igual à figura seguinte. Selecione 
fields e clique duas vezes na opção do field populacao , em 
seguida, clique no botão apply . 
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t Expression editor = 


$ aca 




















Ln 1, Col 13 | 
id Field Integer numberOfLeadingZeros( long ) int J 
nome Field String numberoOfTrailingZeros( long ) int = 
uf.nome Field String bitCount{ long ) int E 
= ? populacao Field equals( Object ) boolean 
PRETO uf.id Field Integer toString() String ] 


Expression Wizards 
toString( long, int ) String 


toString( long ) String 
hashCode) int 
reverseBytes( long ) long 


camnareTal | ann \ int 


Figura 4.8: Selecionando field populacao 








Após configurar as duas propriedades, clique no botão 


Próximo . 
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fix Pie/Pie3D Wizard 





Passos 





1. Dataset 
2. Keys and values 
3. Finish 


To create a Pie chart you need to set which is the 
identifier of each slice and the slice value. 











To create a Pie chart, you have to provide an expression to be used as unique identifier for each slice. The 
expression cannot be null or return a null value. By default this key will be used as label for the slice as well. 











[eztaamos ca 
The size of each slice is defined by a numeric value. Provide here the expression that represents the value 
of the slice. 

[erinan EI 

















[__<Voltar_) [ Próximo> | { Finalizar | [ Cancelar 


Ajuda 











Figura 4.9: Clique no botão Próximo 


Para finalizar, clique no botão Finalizar , e redimensione e 
posicione o componente chart . Clique no componente e, em 


seguida, no botão direito do mouse. Será disponibilizado um menu 
conforme mostra a figura: 


$P{nmSistema} new java.util.Date 


"Pagina" + $V ™ + $V 
Relatorio de Municipio Grafico 





O First @ Second ® Third © Fourth 
© Fifth 


Figura 4.10: Desing do relatório 


Clique na opção Chart Data . Assim, a tela de configuração 
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como verificamos na figura a seguir sera exibida. 
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Ratt 


ioe 


Chart Data 


Padding And Borders 
Hyperlink 


Copiar Ctrl+C 
Recortar Ctrl+X 
Colar Ctrl+V 
Excluir Deletar 


Copy format 
Paste format 


Transform to 


Group selected element(s) 
Ungroup selected element(s) 
Bring To Front 

Bring Forward 

Send Backward 

Send To Back 


Align 

Size 

Position 

Horizontal Spacing 

Vertical Spacing 

Organize As Table Ctrl+Shift+O 


Send to layer 


PDF SNR Tans 
Figura 4.11: Configurando Chart 
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Na tela Chart Details , clique na aba Details e sera 
disponibilizada uma tela com os detalhes da configuração com as 
duas propriedades que ja configuramos, conforme mostra a figura: 


fy, Chart details = 









Type of dataset Pie dataset 























Copy dataset Paste dataset 














Figura 4.12: Aba Details 
e A propriedade Key expression representa o nome 
do Município que será visualizado na legenda. 


e A propriedade value expression determina o 
tamanho da fatia da pizza. 


e A propriedade Label expression determina um 
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label para a fatia da pizza. Essa propriedade só aceita 
tipo String e, como no nosso contexto quero que 
mostre a população e esta é do tipo long , tenho de 
concatenar com espaço em branco para transformar 
população em String ; caso contrário, ocorreria um 
erro. 


fy Chart details m 
Type of dataset Pie dataset z] 


Dataset | Details 











Pie series | Other section value | Other section hyperlink | 
Section value | Section hyperlink 
Key expression 




















Label expression 


[Sr (populacao) + " " 




















Use more series 


Max number of slices to show [ 0H) 











Min slice percentage 0 + 

















Figura 4.13: Configurando label expression 


Clique em close . Terminamos a implementação do relatório 
gráfico; agora, é só compilar e testar. 
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4.2 CONCLUSAO 


Neste capitulo aprendemos a: 


e Adicionar e configurar o componente Chart. 
e Implementar um relatório com gráfico. 


No próximo capítulo, aprenderemos a implementar relatório 
com sub-relatório. 
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CapituLo 5 


RELATORIO COM SUB- 
RELATORIO 


5.1 CRIANDO RELATÓRIOS COM SUB- 
RELATÓRIO 


Layout do relatório 


Neste capítulo, implementaremos o relatório de unidade 
federativa com sub-relatório de uma listagem de clientes que 
moram na unidade federativa selecionada. No nosso exemplo, 
vamos buscar uma lista de clientes que moram no Ceará, conforme 
mostra a figura seguinte. 
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SISTEMA DE GERENCIAMENTO DE CLIENTE 05/07/2015 








id DEVELOPER 
A Pagina 1 de 1 
Relatorio de UF com SubRelatório 
Codigo Nome Sigla 
1 CEARÁ CE 


Lista de Clientes 





Código Nome 





1 GABRIELA LAGUNA 


2 JULIA MAIA 

3 LUCAS MORAIS 
4 MATHEUS FILHO 
5 TIMOTEO LOPES 


Figura 5.1: Layout do relatório 


Método gerarRelatorio 


O método gerarRelatorioSub é responsável pela execução e 
visualização do relatório, como também por acrescentar parâmetros 
comuns para todos os relatórios. Como seu objetivo é gerar um 
relatório com sub-relatório, nos parâmetros do relatório, 
acrescentaremos o caminho completo da localização do arquivo do 
sub-relatório. 


Instanciamos a classe HttpServletResponse para que o 
usuário possa visualizar o relatório. 


public void gerarRelatorioSub(String nomeRelatorio, HashMap 
paramRel,List listaRel,List listaRelSub, 
String subNomeRelatorio) { 
FacesContext context = FacesContext.getCurrentInstance(); 
HttpServletResponse response = 
(HttpServletResponse) context.getExternalContext() 
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.getResponse(); 
ServletContext sc = 
(ServletContext) context.getExternalContext().getContext(); 
String relPath = sc.getRealPath("/"); 
String imagemLogo = 
relPath + "resources/imagens/logo_mmo.jpg"; 
paramRel.put("imagemLogo", imagemLogo); 
paramRel.put("nmSistema", Constants.NOME SISTEMA); 
paramRel.put ("REPORT LOCALE", new Locale("pt", "BR")); 
subNomeRelatorio = 
relPath + "relatorios/" + subNomeRelatorio+". jasper"; 
paramRel. put ("subNomeRelatorio", subNomeRelatorio); 


Após receber dois ArrayList como parâmetro, o ArrayList 
listaRel com as informações do relatório principal e o 
listaRelSub com as informações do sub-relatório, a classe 

JRBeanCollectionDataSource transforma-os em dois 
datasource , são eles: rel e relSub . Acrescentamos como 

parâmetro de relatório o datasource relsub e, em seguida, a classe 
JasperFillManager gera O relatório. 


try { 
JRBeanCollectionDataSource rel = 


new JRBeanCollectionDataSource(listaRel); 
JRBeanCollectionDataSource relSub = 
new JRBeanCollectionDataSource(listaRelSub); 
paramRel.put("relSub", relSub); 
JasperPrint print = JasperFillManager.fillReport(relPath + 
"relatorios/"+nomeRelatorio+".jasper", paramRel, rel); 


Com o relatório criado, configuraremos o objeto response 
para mostrar o relatório no formato .pdf , e a classe 
JasperExportManager exporta o objeto print para PDF. 


response. setContentType("application/pdf"); 
response. addHeader ("Content -disposition", 
"attachment; filename=\"" + nomeRelatorio + ".pdf\""); 
JasperExportManager .exportReportToPdfStream(print, 
response.getOutputStream()); 
ServletOutputStream responseStream = 
response. getOutputStream(); 
responseStream.flush(); 
responseStream.close(); 
FacesContext.getCurrentInstance().renderResponse(); 
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FacesContext.getCurrentInstance().responseComplete(); 
} catch (Exception e) { 
e.printStackTrace(); 


} 


Classe UFMB 


Na classe UFMB , adicionamos o método relatorio , que sera 
responsável pela execução do método gerarRelatorioSub . Neste 
caso, passamos como parâmetro do relatório o nome do relatório e 
do sub-relatório. Acrescentamos dois ArrayList na passagem de 
parâmetro do método gerarRelatório 

listagemResultadoBusca com as informações do relatório 
principal, e o listagemSubRel com as informações do sub- 
relatório. 
public void relatorioSubRel() { 

listagemResultadoBusca = getUfDao().consulta(uf); 

List<Cliente> listagemSubRel = 

getClienteDao().clientePorUF(uf); 

HashMap paramRel = new HashMap(); 

String nomeRelatorio = "relUFCSREL"; 

String subNomeRelatorio = "subRelCliente"; 


gerarRelatorioSub(nomeRelatorio, paramRel, 
listagemResultadoBusca, listagemSubRel, subNomeRelatorio); 


Iniciaremos pelo sub-relatório. Neste caso, nao temos 
parâmetros e nem cabeçalho, redimensionamos somente as áreas 
Column Header e Detail , e criamos somente os fields. Veja a 
figura a seguir: 





Figura 5.2: Criando sub-relatório 
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Em seguida, desenhamos o relatório, conforme mostra a figura 
adiante. Ao finalizar, é importante compilar. 


Lista de Clientes 


Código Nome 


SF{id} $F{nome} 


Figura 5.3: Desenho do sub-relatório 


No relatório que será o principal, criamos os parâmetros, os 
fields, o cabeçalho e detail, e redimensionamos a área Summary . 


$P{nmSistema} new java.util. Dated) 


"Pagina" + $V" + $V 
Relatorio de UF 


Codigo Nome Sigla 





$F{id} $F{nome} $F{sigla} 


Figura 5.4: Criando parâmetro, fields, detail e cabeçalho 


Criamos o parâmetro subNomeRelatório que receberá o path 
do arquivo do sub-relatório e o parâmetro relsub que receberá o 
datasource que será usado pelo sub-relatório. 
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: Paleta > x 

= Report Elements a 
H Break E] Chart 

[=] Crosstab © Ellipse = 

Frame Html 

[E] Image [M] Barcode 

8 Generic Element := List 

43 Spider Chart [E Table 

J Line E Map 

TJ Rectangle f] Round Rectanale z 
: relSub - Propriedades I> x 

[Propriedades 

Name relSub 6) 
Parameter Class (Object ~J 
Use as a prompt 

Default Value Expression P 
Description (a) 
Properties No properties set P 
relSub “a 


Figura 5.5: Parâmetro sub-relatório 


No menu Paleta , selecione o componente subReport , 


arraste-o para a área Summary e solte. Será visualizada uma tela de 


wizard, conforme mostra a figura: 
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‘Paleta > x 





eJ3 Generic Element := List 
4E Spider Chart Table 
/ Line Ç Map T 
a Rectangle {Č Round Rectangle 
bel Static Text = 


a Subreport | [T] Text Field 
= Tools prema Er 
ob Callout [Subrepor nt date [#] Page number 


Figura 5.6: Selecionando componente SubReport 





Na tela Subreport wizard , marque a opção Just create 
the subreport element e, depois, clique no botão para finalizar. 








ÑR Subreport wizard ax 
Passos Subreport (1 of 1) 
1. Subreport 
© Create a new report 
© Use an existing report 











< Voltar Proximo > - Finalizar Cancelar Ajuda 


Figura 5.7: Finalizando Wizard 








Redimensione e posicione o componente Subreport . 
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$P{nmSistema} new java.util.Date() 


"Pagina" + GV" + $V 
Relatorio de UF 


Codigo Nome Sigla 








SF tia) $F{nome} [ Ti $F{sigla} 





Figura 5.8: Redimensionando o componente Subreport 


Clique no componente Subreport e no menu 

Propriedades na propriedade Subreport Expression , clique 

no botão. Assim, uma tela para configuração será mostrada, como 
verificamos na figura: 


: Paleta > x 





8 Generic Element E List 
48 Spider Chart P| Table 
4 Line ® Map E 
(Rectangle {© Round Rectangle 
4 Sort label Static Text 
Te 
=| Tools a 
TA, callout F Currentdate [#| Page number 


Le. vo so os mm a Calma 
Pp adsl 
Print When Expression 


m 








Properties expressions No properties set 
El Subreport properties 
Subreport Expression 


m D 


Figura 5.9: Configurando o Subreport 
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Clique na opção Parameters e, na lista de parâmetro, clique 
duas vezes no parâmetro subNomeRelatório . Depois, clique no 
botão OK. 


Ra - Subreport Expression (adia) 








$P{subNomeRelatorio} 





Ln 1, Col 20 






SORT_FIELDS Paran , | equals( Object ) boolean 


S Fields FILTER Parameter |tostringO String [=] 
J> Variables REPORT_VIRTUALIZE | hashCode() int 
E User Defined Expressions IS IGNORE PAGINAT 


compareTo( Object ) int 
compareTo( String ) int 
indexOf{ String, int ) int 


(4) Recent Expressions nmSistema Paramete 
E Expression Wizards 


imagemLogo Parame 


subNomeRelatorio P| 

















| | indexOf{ int) int 
relSub Parameter Ot + indexOf( int, int) int 
om 
<i ' lindexof(strina) int z 
Te Y | m r 











Import... | { Export... |] 








(o) (conceda) 


Figura 5.10: Configurando o parâmetro subNomeRelatório 








Clique no componente Subreport e no menu 
Propriedades na propriedade connection type , será 
disponibilizada uma lista de tipos. Selecione a opção Use a 
datasource expression e em seguida, será habilitada a 
propriedade Data Source Expression , conforme mostra a 
figura: 
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: $P{subNomeRelat... - Propriedades 1> 


Subreport Expression $P{subNomeRelatorio} (a) 
a oo 
Using Cache 
Run to bottom 


Parameters Map Expression 
Connection type 


Connection Expression 













Use a connection expression 


Use a datasource expression 
Don't pass data. 
Connection type 








Clique no componente 





datasource or without providina anv data. 


Figura 5.11: Configurando a connection type 


Subreport e no menu 


Propriedades na propriedade Data Source Expression , clique 


no botão e será mostrada uma tela para configuração. 
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‘ Paleta > x 
nmo os, SOS 
#8 Generic Element = List 
4E Spider Chart Table 
E] Rectangle (7) Round Rectangle 
v Sort label Static Text = 
Textil 
E Tools 
TO, Callout F Currentdate [#| Page number 
[ms [eee Pe ie | 
: $P{subNomeRelat... - Propriedades > x 
Subreport Expression $P{subNomeRelatorio} PE 
Expression Caso feralmasero o). 
Using Cache 
Run to bottom 
Parameters Map Expression (=) 
m = 
Data Source Expression (us)! 





Figura 5.12: Configurando Data Source 


Clique na opção Parameters e, na lista de parâmetros, clique 
duas vezes no relsub e, depois, no botão OK. 
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hy $P{subNomeRelat... - Data Source Expression = = 












Ln 1, Col 10 








equals( Object ) boolean 
toString) String 
hashCode) int 
getClass() Class 


[5 a [cmi] 














Figura 5.13: Selecionando Data Source 


Terminamos a implementação do relatório com sub-relatório. 
Agora é só compilar e testar. 


5.2 CONCLUSÃO 
Neste capitulo aprendemos a: 


e Adicionar e configurar o componente SubReport. 

e Implementar um relatório com sub-relatório. 

e Implementar o método necessário para gerar um 
relatório com sub-relatório. 
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No próximo capítulo, aprenderemos a implementar relatório 
usando map. 
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CaPiTULO 6 


RELATORIO COM MAP 


6.1 CRIANDO RELATORIOS COM MAP 


Layout do relatório 


Neste capítulo, nosso desafio será implementar o relatório de 
cliente com um mapa da localização do seu endereço. No nosso 
exemplo, vamos mostrar o mapa da localização da casa em que 
nasceu o escritor cearense José de Alencar em Fortaleza - CE, 
conforme mostra a figura: 
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SISTEMA DE GERENCIAMENTO DE CLIENTE 17/02/2015 
É ceveracer 
Relatório de CilMap Page tor 1 
Codigo 8 Latitude -3.811566 Longitude -38.47834 
Nome CASA DE JOSE DE ALENCAR 
Endereço Avenida Washington Soares, 6055 
Observação 


A Casa de José de Alencar esta situada no Sitio Alagadiço Novo, no Dalmo de Messejana, Fortaleza-CE e foi adquindo 


em 1625 peso padre José Martiniano de Alencar, pai do escritor cearense José de Alencar, 


personagem principal 
nossa história Por nove anos, este espaço foi o lar do escritor, autor dos mais renomados titulos da Literatura Nacional, 
com destaque para as obras “Iracema” e “O Guarani”, que foram fortemente Influenciadas pelas belezas naturals do 
estado do Ceará Fonte : http-iwaw.cja.ufe-br? 
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Figura 6.1: Layout do relatório 


Classe ClienteMB 





Na classe ClienteMB , adicionamos o método relatorio que 
será responsável pela execução do método gerarRelatorio. 


public void relatorio() { 
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listagemResultadoBusca = getClienteDao().consulta(cliente) 


HashMap paramRel = new HashMap(); 

String nomeRelatorio = "relCliMap"; 

gerarRelatorio(nomeRelatorio, paramRel, listagemResultadoBu 
sca); 


} 


Iniciamos esse relatório adicionando parâmetros, fields e 
cabeçalho, redimensionando as áreas Column Header e Summary , 
e inibindo as demais. 


Vale ressaltar que os fields de latitude e longitude é do tipo 
float e receberam as coordenadas para definição da localização 
do mapa. Em seguida, desenhamos o relatório, como mostra a 
figura a seguir. 





Código SF(id) 


Nome $F{nome} 


Endereço $F{endereco} 


Observação 


$F{observacao} 


Figura 6.2: Desing do relatório 


No menu Paleta , selecione o componente Map , arraste-o 
para a área Summary e solte. Redimensione e posicione-o, assim 
como mostra a figura: 
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Enderego $F{endereco} 


Observação 


$F{observacao} 


Figura 6.3: Selecionando o componente Map 


Clique no componente Map e, no menu Propriedades na 
propriedade latitude , para exibir a tela de configuração, basta 
clicar no botão e uma tela de configuração será disponibilizada. 
Clique na opção Fields e, na lista de fields, clique duas vezes no 
field latitude e depois no botão OK. 
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fy Map (component) - Lat. Expr. =) 


$P{latitude} 























F Parameters 


= 
= Fields 





id Field Integer 
nome Field String 


J> Variables endereco Field String 
E User Defined Expressions observacao Field String 


E o 
[5] Expression Wizards 


longitude Field String 





equals( Object ) boolean 
toString( float ) String 
toString( String E 
hashCode() int 
floatToRawIntBits( float ) int 
floatToIntBits( float ) int 
intBitsToFloat( int ) float 
compareTo( Float ) int 
compareTo( Object ) int 
huteValuel hy t= 

















Ta 


é 





(impor) (Eme) 











ee es ) [Co 


Figura 6.4: Configurando Latitude 








Clique novamente no componente Map e no menu 
Propriedades na propriedade longitude , para exibir a tela de 
configuração, basta clicar no botão e uma tela de configuração será 
disponibilizada. Clique na opção Fields e, na lista de fields, clique 
duas vezes no field longitude e depois em OK. 
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fz Map (component) - Lon. Expr. 





$F{longit 





Fe Parameters 





J> Variables 

[5] User Defined Expressions 
|| Recent Expressions 

E] Expression Wizards 














id Field Integer 
nome Field String 
endereco Field String 
observacao Field String 
latitude Field Float 


Y 





equals( Object ) boolean 
toString) String 
hashCode() int 
compareTo( Object ) int 
compareTo( String ) int 
indexOf{ String, int ) int 
indexOf{ int ) int 
indexOf{ int, int) int 





indexOf{ String ) int 
«| m 





Figura 6.5: Configurando Longitude 


Ln 1, Col 














Por último, clique mais uma vez no componente Map e, no 
menu Propriedades na propriedade Zoom Expr , informe o valor 


15, como é visto na figura: 
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Evaluation group 
Lat. Expr. SF {latitude} 


Lon. Expr. $F {longitude} 
E 


Language (ISO code) exp. 


Map Scale 
6 





Zoom. Expr. 
The zoom used to render the map 


Figura 6.6: Configurando o Zoom Expr 


Terminamos a implementação do relatório com Map. Agora é 
só compilar e testar! 


| Endereço $F{endereco} 


Observação 


$F{observacao} 








Figura 6.7: Finalizando o relatório 


6.2 CONCLUSÃO 
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Neste capitulo aprendemos a: 


e Adicionar e configurar o componente Map. 
e Implementar um relatório com Map. 


No próximo capítulo, aprenderemos a implementar relatório 
usando Crosstab. 
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CAPÍTULO 7 


RELATORIO COM 
CROSSTAB 


7.1 CRIANDO RELATORIOS COM CROSSTAB 


Layout do relatório 


Nosso último desafio será implementar o relatório de 
Municípios com Crosstab, conforme mostra a figura: 


















































SISTEMA DE GERENCIAMENTO DE CLIENTE 22/02/2015 
[id DEVELOPER 
Pagina 1 de 1 
Relatorio de Municipio 
Ceara Rio de Sao Paulo i 
janeiro Total Linha 
Fortaleza 500 0 0 500 
Aquiraz 50 0 0 50 
Guaramiranga 300 0 0 300 
Juazeiro do 200 0 0 200 
Quixada 100 0 0 100 
Rio de Janeiro 0 800 0 800 
Sao Paulo 0 0 999 999 
Total Coluna 1150 800 999 2949 
Figura 7.1: Layout do relatório 
Classe MunicipioMB 


Na classe MunicipioMB , adicionamos o método relatorio 
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que será responsável pela execução do método 
gerarRelatorioSub . 
public void relatorioCrossTab { 
HashMap paramRel = new HashMap(); 
List<Municipio> listaRel = 
getMunicipioDao().consulta(municipio) ; 


String nomeRelatorio = "relMunicipioCT"; 
gerarRelatorio(nomeRelatorio, paramRel, listaRel); 


Iniciamos esse relatório adicionando parâmetros, fields, 
cabeçalho e agrupamento por UF, redimensionando a área 
Summary , e inibindo as demais. Veja a figura a seguir: 


$P{nmSistema} new java.util.Date() 


"Pagina" + $V ™ + $V 
Relatorio de Municipio Crosstab 


Figura 7.2: Desing do relatório 


No menu Paleta , selecione o componente Crosstab , 
arraste-o para a área Summary e solte. Será visualizada uma tela de 
wizard, conforme mostra a figura: 
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= Report Elements 

H Break [Se] Chart 

é = | Crosstab © Elipse 

[E] Frame [Crosstab] [cal Html 

[E] Image HI] Barcode 

e} Generic Element := List 

4 Spider Chart M Table 

/ Line Q Map 

C] Rectangle {© Round Rectangle 





Figura 7.3: Selecionando componente Crosstab 


Na tela inicial do New crosstab , clique no botão Próximo . 








E i 
Ra New crosstab exon 
Passos Dataset 
1. Dataset 
2. Rows Dataset 
3. Columns EEE ] 
a heme Main report dataset X 
5. Layout 








< Voltar | | Próximo > Finalizar | Ajuda 











Figura 7.4: Iniciando configuração Crosstab 


No passo Rows , dando início à configuração da grid na 
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combo box group , selecione o atributo nome que será impresso 
na primeira coluna da grid, conforme mostra a figura a seguir. Em 
seguida, clique no botão Próximo . 





fix New crosstab 





Passos Rows 


Dataset 


Rows 
Columns 
Measure 


Layout 


nd pm 


Define row groups 






Row Group 1 


Group | 


nome Field String = 
Group By Unique X | 
Row Group 2 
Group | = 
Group By Unique X ] 


sa — 


E 


| < Voltar ( Próximo > Finalizar Ajuda 























Figura 7.5: Selecionando field nome 


No passo Columns , na combo box group , selecione o field 
uf.nome que será impresso na primeira linha da grid, como a 
figura a seguir. Depois, clique no botão Próximo . 
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r 5 
fiz New crosstab DO] 












Passos Columns 
1. Dataset 
2. Rows 
3. Columns 
4. Measure 
5. Layout 
Define column groups 
r Column Group 1 — - 
Group | yf.nome Field String X 
Group By (Unique z] 
[ Column Group 2 
Group | ac] 
p Group By (Unique v ] 
wa | 
Próximo > Finalizar Ajuda 








Figura 7.6: Selecionando field uf.nome 


No passo Measure , na combo box measure , selecione o field 
população e, na combo box function, selecione a função Sum, 
como visto na figura adiante. Então, clique no botão Próximo . 
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r 5 
thy, New crosstab s= 





Passos Measure 
1. Dataset 
2. Rows 
3. Columns 
4. Measure 
5. Layout 
Define measure 
Data 
Meme populacao Field Long X 
Function | 











l < Voltar | [| Próximo iam) Finalizar Ajuda 




















Figura 7.7: Selecionando field populacao 


No passo Layout , para finalizar a configuração, opcionalmente 
podemos adicionar totais por linha e por coluna. Em nosso 
contexto, vamos manter os totais, conforme mostra a figura adiante. 
Em seguida, clique no botão Finalizar. 
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; fiz New crosstab 





Passos Layout 
1. Dataset 

2. Rows 

3. Columns 

4. Measure 

5. Layout 























V] Add row group totals 
| Add column group totals 
4] Show grid lines (adding cell border) 























oe 





< Voltar | Próximo > ] ajuda | 


Figura 7.8: Adicionando Totais 








Na tela de designer, clique na aba Crosstab . 
































[E relMunicipioCT.jrxml x | [as relMunicipioCT.jrxml x NO) 
XML Preview [8 @ Q |7f7)|sansserf jo jan|b iu s====EE 
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nome} nome 
== 
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E var 








Figura 7.9: Selecionando aba crosstab 
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Nesta aba, opcionalmente podemos alterar o nome do label dos 
totais e redimensionar as colunas, como pode ser visto na figura: 
(ás, relMunicipioCT jrxml x [es relMunicipiocT. jrxml x 
Designer XML Preview S Q Q |B |Sansserif - [10 -A ‘A | bius=z= 
2 3 


Q 1 4 5 6 7 











$P{nmSistema} new java.util.Date) 


$Vfur 
Eil nome) | Total 
| WiTome) V 


Total Coluna 


"Pagina" + $V ™ + $V 
Relatorio de Municipio Crosstab 














vt Main report Bel Crosstab 1 





Figura 7.10: Alterar label de totais 


Terminamos a implementação do relatório com Crosstab! Só 
resta compilar e testar. 


7.2 CONCLUSÃO 


Neste capítulo aprendemos a: 


e Adicionar e configurar o componente Crosstab. 
e Implementar um relatório com Crosstab. 


Concluímos aqui o nosso livro que teve como objetivo ensinar a 
implementar os principais tipos de relatórios utilizando o iReport. 
Espero que o leitor possa aproveitar os conhecimentos adquiridos 
com a leitura deste livro no seu dia a dia como desenvolvedor. 
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Participe do nosso fórum de discussão, em 
https://forum.casadocodigo.com.br, para tirar dúvidas, críticas e 
sugestões. 


Para baixar o código-fonte do aplicativo de demonstração, 
utilize o link do GitHub: 
https://github.com/mmmauricio/ireportCrieRelatoriosPraticosEeleg 
antes. 
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CapituLo 8 


APENDICE 


8.1 INTRODUCAO JASPERSOFT STUDIO 


Segundo o site Jaspersoft Community, o Jaspersoft Studio é a 
nova ferramenta de geração de relatório baseado em Eclipse para 
JasperReports e JasperReports Server. É uma reescrita completa do 
iReport Designer, disponível como plugin Eclipse, e como um 
aplicativo independente. Jaspersoft Studio permite que você crie 
layouts de relatórios sofisticados que contêm gráficos, imagens, sub- 
relatórios, tabelas de referência cruzada e muito mais. Você pode 
acessar seus dados através de JDBC, TableModels, JavaBeans, XML, 
Hibernate, CSV, e fontes de costume, em seguida, publicar seus 
relatórios como PDF, RTF, XML, XLS, CSV, HTML, XHTML, 
texto, DOCX ou OpenOffice. 


O principal objetivo da Jaspersoft Studio é fornecer os mesmos 
recursos e funcionalidades do já conhecido editor de relatório 
Jaspersoft, disponível no iReport Designer. Tendo seus 
fundamentos na plataforma Eclipse, Jaspersoft Studio é uma solução 
mais completa. 


Designer iReport e Jaspersoft Studio também permitem 
configurar fontes de dados e utilizá-los para testar seus relatórios. 
Em muitos casos, os assistentes orientados por dados podem ajudar 
você a criar seus relatórios muito mais rápido. iReport Designer 
inclui o motor JasperReports, que permite que você visualize sua 
saída do relatório, teste e refine seus relatórios. 
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8.2 INTERFACE DO USUARIO 


Jaspersoft Studio é oferecido em duas versões diferentes: um 
produto RCP autônomo, e uma versão plug-in do Eclipse. Pessoas 
que trabalharam com Eclipse vão estar familiarizados com a 
interface do usuário, enquanto para os novos usuários, ou os que 
estão familiarizados apenas com iReport Designer, a disposição dos 
elementos mostrados aparece bem diferente. Ambos o standalone e 
a versão plug-in têm uma interface similar. Na imagem a seguir, 
você pode ver uma prévia da interface Jaspersoft Studio, com as 


principais áreas em destaque: 











Figura 8.1: Interface 


8.3 NOVOS RECURSOS DO JASPERSOFT 
STUDIO NÃO DISPONÍVEIS NO IREPORT 
DESIGNER 


1. Um novo poderoso editor de expressão com a capacidade de 
usar funções embutidas e criar novas. 

2. Herança Estilo. 

3. A ajuda contextual disponível através da aplicação. 

4. Exemplos disponíveis através do "New Project" wizard. 
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15. 


16. 


17. 


18. 


. "Feedback" diálogo: permite enviar emissão / solicitação de 


recurso / bugs etc. diretamente para a comunidade, anexando 
registros úteis ou informações de software e hardware. 


. O suporte nativo para adaptadores de dados (permitindo ter 


provedor de editores / campos já durante a criação do 
relatório). 


. Melhoria no mecanismo para lidar com o relatório publicado 


e modificado no servidor. 


. Capacidade de fornecer valores de tamanho e posição 


recorrendo a diferentes valores de pixes para imagens (ou seja, 
digitando '0,5 centímetros”). 


. Melhor gerenciamento classpath. 
10. 


Melhoria (pixel) de precisão na concepção de relatório 
(especialmente quando se utiliza zoom). 


. Melhoria na maneira de criar elemento. No iReport, você tem 


que clicar na paleta; manter pressionado e soltar o elemento 
no editor. 


. Apoio a projetos. 
. Melhoria do ambiente de execução, com a possibilidade de 


definir dinamicamente o relatório. 


. O ambiente de execução fornece relatórios de estatísticas de 


execução precisos, como número de registro, o tamanho do 
arquivo, execução e tempo de execução. 

Os relatórios são gerados de forma assíncrona, permitindo 
visualizar quase imediatamente as primeiras páginas de 
relatórios. 

Capacidade de executar um relatório interativo e vê-lo dentro 
do visualizador de relatórios web integrada Jaspersoft Studio. 
Habilidade para escrever e testar componentes JR e 
adaptadores de dados no Eclipse e testá-los diretamente no 
Jaspersoft Studio instalado como plugin do Eclipse. 
Capacidade de gerenciar o suporte para fontes e componentes 
personalizados por projeto. 
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19. Licença EPL que permite a reutilização do Jaspersoft Studio 
em aplicações baseadas em Eclipse RCP. 

20. Recursos disponíveis no Eclipse incluem a integração de 
controle de versão e histórico de alterações. 


Jaspersoft Studio já está disponível para os sistemas operacionais 
Windows 64 bits ou de 32 bits, Linux 64 bits ou de 32 bits, Mac OS 
X 64 bits e Java Development Kit (JDK) 1.6 ou mais recente a partir 
deste. 


Para maiores informações sobre Jaspersoft Studio você também 
pode consultar a documentação oficial. 


Introduction to Jaspersoft Studio 


http://community.jaspersoft.com/wiki/jaspersoft-studio- 
tutorials-archive 


Jaspersoft Studio Features 


http://community.jaspersoft.com/wiki/jaspersoft-studio- 
features 
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CapiTULo 9 
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